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Preface 



About This Book 



his book shows you how to start using HyperTalk"^, the language 
chat's built into HyperCard^ IIGS^ With HyperTalk, you can write 
your own instructions, called scripts, for HyperCard to carry out. 
Writing scripts is called scripting. 

You can create, ctisfomize, and personalize HyperCard stacks 
without learning how to write scripts; but scripting with HyperTalk 
gives you even more control over your cotnpucen 

If writing scripts sounds a lot like programming to you, you're 
right; however, you do not need ^ny previous experience widi 
programming to write scripts. If you can read diis paragraph, you 
can write a script. 
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What you need To get chc most out of this book, you should already know the 
to know to LISC l^^^-"^'*^ of using an Apple'^ IIciS computLT; ior insr:\ncc, how lo use 
J , ^ - die mouse, menus> and icons on die screen. You should also know 
IlllS DOOK liow to find your way around in a HyperCard stack. If you have 

gone through the first three or four chapters of Getting Started witlj 
HyperCard lies, you probably know cnotigh to begin. 

Specifically, you should know how to use button^i to get around in 
stacks and how to use the HyperCard menus and tools. You should 
have browsed dirough some sracl^s, looked through part oi the 
HyperCard IlGS Help stack, and perhaps personalized a stack — ^for 
example, you might have used the Address stack to store some 
information. 

If you already have experience with programming in another ^ 
language, you mighr want to go directly to the HyperCard IIgs 
Script LangtMge Guide, published by Addison- Wesley Publishing Co. 

This book is intended to help you get started and let you get a feel 
for scripdng on your own. You won t find long, technical 
explanations of HyperTalk concepts here; but you will be able to see 
clearly how specific scripts work 



How to use Most chapters in this book include exercises made up of numbered 
this book ^^^P''^- ^^^P ^^'^^i^^^ ^ short instruction in boldface type and 
then (usLKtlly) furrher explanation in plain type. Depending on your 
level of expertise with HyperCard, you may find that you can savf||^ 
time in some of the exercises by reading just the boldface steps, Of^ 
course you can stop and read the more-detailed explanations in 
plain type whenever you need to. 
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Each chapter builds on whiic youVe done in previous chapters, so 
it s importiint that yoii scart at Chapter i and work through the 
book in order. 

■ In Chapter 1. ''Getting Started." youH create a practice stack, 
which you'll use for scripting throughout this book. You'll make 
some buttons for the stack and complete their seripts. 

■ In Chapter 2, "1-ields and Other Cotuainers," yuLi'll write some 
simple script^s thai explore the way HyperCard stores and 
retrieves information. 

■ In Chapter 3, ''Scripts That Make Decisions." you'll write some 
more powerful scripts. 

■ \n Chapter 4, "Handling Messages." you'll explore how burtons 
and other objects receive and send messages. 

■ hi Chapter 5^ "More Scripting ideas," you'll look at other ways 
you can use scripts in stacks. Youll see how ro create animation, 
a presentation stack, and a stack just fo: Rm. 

■ The Appendix, "HyperTalk Summar)'," contains a complete list 
of HyperTalk commands, functions, and other elements. 

You'll also find a glossary of terms, an index, and a quick reference 
card, which you can remove from this book and keep handy while 
you work on your scripts. 

At the end of the book is a Tell Apple card. By answering the 
questions and mailing the card to Apple, you help lis improve our 
products and documentation. Fill the card otit after you've worked 
with this book. 
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Other sources of Because this book is intended as an introduction to scripting for 
|j-J^QjY|-j^|-|QII beginners, it is not comprehensive. HyperTalk comprises many 
commands, funcrions, keywords, and odier elements that are nor 
explained in this book. The HyperCard package includes the 
following reference materials: 

HyperTalk Help: A stack that provides easy access ro information 
-^^^ about HyperTalk. You will find this stack 

^^^^^ indispensable as yon begin to learn scripting. 

HyperCard IlGS Help: A ^VAck that answers your questions about 
-^^"^i HyperCard's menus and tools. 




HyperCard Has Reference: hhook that contains reference \ 
information about all aspects at HyperCard other 
dian scripting. 




You may also want to consult the following books, which were 
written at Apple arid are published by Addison- Wesley as part of the 
Apple Technical Library: 

HyperCard Stack Dmgfi Guidelines: A book that provides 
information about how to design and build stacks. Its focus is the 
look and behavior of stacks (for example, navigadon methods and 
card layouts) rather than the mechanics of scripts. 

HyperCard IIgs Script Language Guide: A book that provides ^ 
detailed reference information about scripts and HyperTalk. This 
book is for people with some programming or scripnng experience. 

Several other books have been written about HyperTalk. Check 
with your favorite bookseller to see what titles are carrendy 
available. 
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Getting Started 



TT 

X Xave you ever wished your computer could do things your way? 
Mosr applicadon programs are designed to perform one type of 
task, lil^e word processing or creating grapiiics. Bur what about all 
the things you do that donr fit neady into other people's categories? 

HyperCard*' IIgs^ lets you creare your own ways of doing 
things on your computer. If you have read Ceuing Started tvith 
HyperCard /k,'S, you already know how to work with HyperCard 
tools such as the Button and Field tools. This guide introduces you 
to scripting — writing sets of instructions called scripts zh^i give you 
even more control over the way HyperCard stacks work. 
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HyperCard scripts arc written in the HyperTalk*" langu^, which is 
similar to English in many ways. HyperTalk uses common words 
such as go, put, LUid h in much the SLUiie way thai people u^ie ihcsc 
words in everyday life. In this book you'll learn how to combine 
these words with other words to form instructions that HyperCard 
can understand. As you work through die book, you'll build your 
vocabulary of HyperTdk words. You'll also learn how to write 
larger, more powerful sets of instructions. 

You do not need any prior experience with computer languages to 
use this hook. You should, however, loiow how ro get around in 
HyperCard stacks, and how to use some ot the tools de^lCribed in 
Getting Started with HyperCard lICS. 



What you will build In tliis book you^li learn scripdng by building a practice srack from 

scratch and wridng scripts for it. If you work throtzgli Chapters 1-4 
in order, you II end up with a stack you can use to caralog a collecfion 
of record albtims. cassettes, or compact disks. (Figure 1-1 showsa 
saji^ple card from a completed version of die practice stack.) 
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Figure 1-1 Sample card from the praclicc slack 
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If you done fee! like cataloging a collection of recordings, donr 
worry. In Chapter 5 you'll learn how to modify the practice stack 
for other purposes. You can modify it to keep track cit buoLs, 
baseball cards> computer software, your fevorice restaurants, the 
inventory for a business, or anything else you might want m catalog- 
Here are some examples: 



W1I M 

itDllDn 



- restaurants 

J=i:i;'.[:'UiSS^ 




model 



Tim's 

Classk Cars 




Utl Rbflbttbii Quit 



Figure 1-2 Some viirLiLkms on iIk prdclite si^ck 



As you build the practice stack, you 11 learn basic scripting concepts 
and techniques. By the time you're finished with this book, you'll 
laiow enotigh to create stacks for your own purposes. 

Each chapter in diis book builds on material you Ve completed In 
previous chapters, so you should go through the chapters in order. 
In this chapter you'll create the practice stack and write some simple 
scripts CO control die actions of buttons. 
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1 lits book \s meant to be used with HypcK^ard ''up and mnning" 
nn your Appk' IkA" compiinjr. You'll need to perform the steps 
as dii ected in the sections diiit follow to get the most out of the 
material. 

First, start up HyperCard as you normally would, (The HyperCard 
IIgS Refireucc includes instructions if you need them.} If you already 
have HypeiOrd running, go to the Home stack. You're ready ro go 
un whcEi you see the first card of the Home stack on your screen. 



Staiting Lip 
HypeiCarcl 




Figure 1-3 The first c;ird of the Home smck 



Setting your Towork with .scripts, your user level must be set to Scripting. Stan 

ILSer level ^^^^ ^^"^^ Home stack and set your tiser level as 

described in the following steps: 

1 , Click the User Preferences button. 

The User Preferences card appears. 
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2. Click the Scripting button on the User Preferences card. 

For now. leave the check box options Blind Typing, Power Keys, 
and Text Arrows unchecked. (For more information about these 
options, refer to the HyperCard liGS Reference.) 

Figure I -4 shows the User Preferences c^ird with Scripting 
selected. 
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Figure 1-4 The L'st^r Preferences curd of the Home stack 



When you set rhc user level to Authoring or Scripting, a new 
menu tide, Objects, appears in the menu bar. Commands in [his 
menu allow yoti to get information about imd change properties 
of HyperCard objects — buttons, fields, cards, backgrounds, and 
sracb. {You'U learn more about objects later on.) The user level 
mtist be set to Scripting before you can look at, write, or change 
these objects' scripts. 
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Creating a Now diiit youVc set the user level to Scripriiig. the next rusk is 
practice stock ^^^^ace the sr^ick chat you'll work with throughout chis book. You 

um make a new srack ac any cinie from anywhere iji HyperCard; 
you don r have ro go back to the Home card. Just follow diese steps; 

\. Choose New Stack from the File menu, 

A dialog box appears in which you can name the stack. 

2. Type die name collection for your stack: 

If you make an error while typing the name, use die Delete key 
to erase it and retype. The dialog box shouJd look similar to this: 



<ifl*;HordDi5k. 



D HyperCcrd 



NFwStQckNoaiE: 



tall^ction 



[ Vol Jigs j 

[ Open ~) 
( nail 1 

jrente ^ 
C Cancel ~ ] 



r~] Coptf Ckirrf nt Background 



Figure 1-5 The New Stutk dialog box 



From now on your practice stack will be referred to as the 
Collection stack. 
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3. When youVe ready, dick Create (or press Return). 

You should see a completely blank card oji your screen with the 
menu bar at the top. This card is the first — and right now the 
only — card of your Collection stack. 

When you create a new stack, you automatically get three things: 
the stack itself, a background, and the first card. If you selected the 
Copy Current Bacl^round option, you wouJd also get the 
background pictures, fields, or buttons of the card you were on 
when you chose the New Stack command. Otherwise, as in this 
case, you h;ive a blank card to work with. 



You can think of the back^oundm HyperCard as a kind of 
"holding area" for general elements. If a picture, a field, or a button 
is in the background, it appears on every card that shares that 
background. If you put a button in the background, for example, 
you will have that button constantly available throughout a number 
of cards — you don't need to re-create it on every card. So far the 
Collection stack has onJy one background, so all the cards you 
create will share that background. 

In the rest of this chapter you II add buttons and fields to the 
background of the Collection stack. 



Working in the 
background 
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llcft>ic you go oil, 

■ Clioosc Background from the Edii mcTiii. 

The word B/j£-kg>vnjic^ appt^^rs in the menu bar, indicating thac 
you re working in die background; 



1 6c Taoli Dbjfcii 





:a 


Cut 






i'lC 




6V 






Km Card 




Dtlrtt Card 




Cut Card 




COPH Card 




Tflit^tylf I'lT 



This indicalci 
you're working m 
ihc lJin.\L;nniiul, 



Figure 1-6 Wtirkin^ in the hack^roiind 



You can also work in the background by pressing ^ -B. (The 
key is called the Command key and is to the left of the Space bar 
on the keyboard,) Keyboard shortcuts like ' -B can save you a 
lot of time when you're creating a stack. You'll have manv 
opportunities to practice HyperCard s most useful keyboard 
shortcuts as you work through this book. 
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Aiid now . . . 
a little scripting 

Creating a Home button 
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[n this section you will create a button and write ii script for it. You 
may already know how to copy atid pa^te buttons wiih prewritten 
scripts. Ill this book you'll complete the scripts yourself. 



Whenever you see a smaJI picture of a house in HyperCard, you can 
be pretty sure that clicking it will take you to the Home card- In 
this section you'll add a Home buttoti to your stack and complete 
its script. 

First youll create the button. You may already know how to create 
buttons by choosing New Button from the Objects menu. In 
this book you'll use a keyboard shortcut to create buttons. Follow 
these steps: 

1 , Make sure youVe working in the background. 

You should see the word Back^oitnd'w'x rhe inerui bar. If vou 
don't sec Biickground, press -B. 

2. Choose the Button tool from the Tools menu. 

The pointing hand (Browse tool) on the screen changes to an 
arrow pointer. 

If you prefer to work with a palette, you can turn the Tools 
menu into a palette by dragging past irs bottom edge to '"tear" 
it off the menu bar. 

3- With the pointer anywhere on the card, hold down 
the " key. 

The arrow pointer changes to a crosshair. 
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4. While holding down the ' ^ key, press the mouse button and 
drag to create a small button about half an inch square. 

Release [he mouse button and the " key when rhe burton is 
approximately the correct size. The new burton is automacicaily 
selected — you can tell by the moving dashed line around its 
edges- (This effect is somenjnes called "marching ants. ") While 
it's selected, you can stretch or shrink the button by dragging 
a corner. 

5- Move the button to the lower-right comer of the background. 

To move ihe button, position the pointer near the center of the 
button and drag. 

Because the button is in the background, it will appear in rhis ^ 
position on every card in rhe stack, so you can iilways go Home, 

6. Double-click die button to see its Button Info dialog box. 

Or choose Button Info from the Objects menu. 



Butt an Hone. I 

Bkgnd button njnber: 1 Bkgnd button [B 1 
□ ShawNoiit Style: | tfonsporent"^ 

n Shore HiUtp ' 



I Icpn... 1 
[linHD. ] [ font.. ] 

[ Script... 1 [Colors...] ^ OK J [Cortcpl] 



Pop-up menu [fir selling 
a liuiiun's sivli,' 



Figure 1-7 A Huiifin InfV) diulog hox 
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HyperCard burtons have a variety of styles and features from 
which to choose. You customize a button s appearance and 
actions through tlie Button Info dialog box. 

A vertical bar marks the insertion point in the Button Name 
box, ready for you to type a name, 

1. Type Home to name the bunon (but don t press Return). 

If you press Return prematurely, don t worry; just double-click 
the button again to get back to the Button Info dialog box. 

8. Click the Auto Hilite check box to select it. 

The Auto Hilite option causes the button to briefly change color 
when it s clicked. 

9. Click the Icon button. 

Another dialog box appears in which you can select an Icon for 
the button. 

10» Choose one of the house icons. 



Scroll through the window until you find the house icons and 
Some house icons cUck the one you want. 

11. Click OK to close the list of icons. 

You see the Button Info dialog box again. 

Next you 11 write a script for this button. 
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Wnli^^^ [liL' sci ipi 

You create and change scripts in a dialog box called the script editor. 
To see the script for the new Home burron, make sure the Button 
tool is selected, and follow these steps: 

I , Click the Script button in the Button Info dialog box. 

The script editor For die Home button appears. 



Script of ekgnd button ID 1 = "Hone" 



[ Find 1 C Print ] 



( DK ) ( CanctL ) 



Figure 1 -8 Hit' snip! alitor 



Notice that [he text at die cop of the script editor identifies this 
script ;ls '\Script of Bkgnd button ID 1 = "Home"" — your new 
button. Notice also the vertical bar cursor. 

The next step is to type the statements that define the 
buttons action. 

2, Type on mouseUp and press Return, 

Be sure to type mouseup as one word. \i you m.ike a 
mistake, use the Delete key to erase it and finish typing the 
script correcdy. 
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3, lype rju \.u :il^cy. "Horne" and press Return. 



4. Type end moiiseUp and press Return. 

These three lines make up the complete script for the Home 
btirton. 

on mouseUp 

go to stack "Home" 
end mouseUp 

The script editor automatically indents lines witl^in scripts. This 
indenting helps you check your scripts. On and end should 
always line up at the leftmost edge of the script editor when 
you're finished typing a script; if they don't line up, press the Tab 
key to check the script's formatting, [f they still don t line up, 
you may have left out something importanr; check the script 
again. 

❖ By the way: It doesht matter how you capitalize HyperTalk 
words. Words that are fomied from two words (such as 
mouseUp) aTC usually typed in small letters widi a capital In the 
middle likeThis to make them more readable. ^ 

To save your script and leave die script editor: 

5. Click OK. 

The script editor disappears, and you re looking at die 
Collection stack with your new button. 

By clicking OK (or pressing die Enter key), you save any 
changes you made to the script and return ro the stack you're 
working on. If you click Cancel, you close the script editor 
without saving changes. 
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Tiyiny out the Homt? button 

Now see if the Home button works as it's supposed to. 

1 . Choose the Browse tool from the Tools menu. 

2. Click the Home button, 

I he Home stack appears. Welcome Home! 



li" something else appears, such as a dialog box saying "Can't 
understands" you may have made a typing mistake. Switch to the 
Burton tool, double-click the Home button, and click Script in the 
The liriJwst'liK)! Burton Info box to check the script. Make sure everything is 
correct, then click OK and try out the Home button again. 



Huw liic script works 

As you might guess, the script you wrote describes what should 
happen when someone clicks the Home button. 

Whenever you move the mouse> your Apple lies computer and 
HypeiCard software track the movement electronically. You see the 
movement as a change in the position ot the pointer on the ,screen. 
When you press and release the mouse button, the mouse send^ an 
electricil signal to the computer, much the way a light switch works 
when you turn it on or oft. The same thing is true when you press 
different keys on the keyboard. The HyperCard software interprets 
these signals from the system and translates them into HyperTalk 
system messages. ^ 

Mousetip is a system message that means the mouse button has been 
released; an on-screen HyperCard button receives this message 
when someone clicks it (that is, positions the Browse tool on ir and 
then presses and releases the mouse burton). 

Whether something happens when the on-screen button receives 
the mouseup message depends on whether the burtons script 
contains any instructions for that messiige. 
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The first line ot your script, on mouseup, signals HyperCard that 
insrrucrions for the mou^eUp message exist. J he nexE line, go to 
stack "Home", tcUs HyperCard to go to the Home stack. 

The word go is a HyperTalk command; it means what yoti might 
expect. Go must be followed by a destination — a description of a 
stack or a card. In this case, yoti used the name of the stack Home. 

Each line in a script is called a HyperCard statcmmt. In a more- 
complidted script, the instructions sign^dled by mouseUp could 
consist of many statements. The last line of your script, end 
mouseup, indicates the end of the instructions for the mouseup 
message. 

Translated into English, the instructions in your script say: 

"When someone clicks this button, go to d:e Home stack That's all." 

Adding a button to the Woutdn t it be convenient to have a button in die Home stack diat 
Home stack would take you direcdy to your collection stack? In this section 
you'll create one. 

Make sure you're looking at the Home stack and follow 
these steps: ' 

1. Choose the Button tool, 

2. Wliilc holding down the " key drag to create a new buUon. 

Make the button about an inch wide and a half-inch high. Move 
it to any open space on the card. 

3. Double-click the bunon to see its Info box, 

4. Name the button Collection 
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5- Click Show Nanie and Auto Hilitc to select them. 

Wlit-ri Show hl'Amc is sclctccd, the buttons name appears inside 
the button. 

6, Click Icon. 

Tlie list of icons appears. 

7, Choose the stack icon. 

8, Click OK to close the list of icons. 

'I'hc Button Into dialog box appears again. 

Writing the scripl ^ 
Now you're ready to write the script. 

1. Click the Script button to see the script editor. 

2. Type the following script (pressing Return at the end of 
each line): 

on mouseUp 

go to stack "Collection" 
end mouseup 

3- CUckOIC 

The Home stack appears with the Collection button in place. 

4. Try out the new button by clicking it with the Browse took 

If your Colleaion stack appears, congratulations! ^ 

❖ If something else happened: You may have misspelled a word or 
left out a space in the buttons script. If you got a directory dialo 
box asking where the stack is, you [iiay have typed die stack's 
name incorrectly. '> 
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The words go to stack "Collection" tell HyperCard CO go CO the 
Collection stack. HyperTalk is a flexible language; any of these 
statements woiJd also have worked in the button s script: 

go '^Collection" 

go to "Collection" 

go to card 1 of stai^k. "Collection" 



Message handlers You may already know chat buttons, fields, backgrounds, cards, and 

stacks are HyperCard elements known as objects. An object can send 
and receive messages. (For example, when you click a button, the 
button receives a mouseup message-) As youVe seen, when an object 
receives a message, it can act on the message according to 
instmccions in the object's script- More specifically, the object acts 
according to instmctions in the message handler 

A message handler is a set of instruaions to be carried out when a 
particular objea receives a pardcular message. It's called a handler 
because it ''handles" the message. Handlers always begin with the 
word on and end with the word end, and both words are followed 
by the name of whatever message the handler deals with — for 
example, on mouseup. Each oi the scripts you have written so far 
contain only one message handler, but an object's script can contain 
a number of handlers, each one handling a different message. The 
word script dierefore refers to all the handlers for a given object. 
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\n same ways writing a script for a HyperCard object is like training 
a dog (see Figure 1-9). The dog is like a HyperCard objecr, and a 
spoken conini;uid is like a niejisage. Each of die dog's tricks — the 
response of a particular dog ro a pardcular command — is like a 
message handler. And the sum total of all die dog's rricks represents 
the "script" for the dog. When the dog receives a message (for 
example, "fetch"), the dog searches through its scripr for the 
appropriate handler and then acts according to the instructions in 
that handler. 




on sit 

sit down 
wag my tail 

end sit 

OIL fetch 

get the stick 
bring it baclc 

end f eCch 

on shaken EindiB 

rai£e iny paw 
end shalceHands 



Strip! 



handler 



Figure 1-9 Message handlers; an analogy 



By the way: The words on and end belong to a special group of 
HyperTalk words known as keywords. Keywords are used Co w 
control which statements are executed in a script. * 
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Visual effects cm m:ikc chc movement from one aird to another 
more obvious and interesting. In this section you'll learn how to 
write scripts to display visual effects. 



Adding a visual effect to the Home button 
First modify the script for the Home burton. 

1, Choose the Button tool- 

2. Double-click the Home button to see its Info dialog box. 

3, Click Script, 

The script editor appears showing the buttons script. 

❖ By the way: Even diough you had to switch to the background 
when you created this button, you do not have to switch to the 
bacicground to change its script. ■> 

4, Click before the word go to set the insertion point at the 
beginning of the second line. 

5. Type visual effect barn door close and press Return. 
The script should now look like this: 

on mousetip 

visual effect barn door close 

go to stack "Home" 
end mouseUp 

6. Click OK. 

7- Choose the Browse tool and click the Home button. 

The first card of the Home stack gradually appears on the 
screen, closing in from the edges of die screen. 
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Atkfinji :i viMi;il vi fixi lo ihi' Colkrlion hiillon 

Now you'W nnxJify Hic script for tht Collt-ction burron rhiif you 
added to die Home smcfc You U use a shortcur for seeing a burton's 
scripL 

L With the Browse tool chosen, hold down the and Option 
keys* 

Pressing these two keys lets you see the oudines of all buttons on 
the card. 

2. While holding down ' and Option^ click the Collection 
button. 

The script editor appears showing the buttons scripL (Release 
the keys after the script editor appears.) " 

The (-^^-Option-click shortcut allows you to go directly to a 
buttons script without switching to the Button tool first — a 
handy feature when you re doing a lot of scripting. 

3. Click before the word go to set the insertion point at the 
beginning of the second line. 

4. Type visual effect barn door open and press Return. 
The Collection buttons script should now look like this: 

on mouseup 

visual effect barn door open 

go to stack "Collection" 
end mousetJp ^ 

5. Click OK. 

6. Try out the Collection button. 

The first cird of your Collection stack appears Co open from rhe 
center of the screen. 
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The* syntax o\' the visual command 



All languages — for people aiid compiicers — liave niles of syntax. 
Syntax is a description of the way in which words are combined to 
form meaningful statements. For example, in English the statement 
''Go to the store" makes sense because it follows the rules of English 
syntax. However, the statement "The go store to" doesn t make 
sense because it doesn't use proper syntax. 

HyperTalk syntax is much like English syntax, which makes 
HyperTalk an easy language to tise. It s not always true, however, 
that a statement that makes sense in English will make sense in 
HyperTalk For example, HyperCard cannot understand the 
command 

visual effect slowly dissolve 

because die words are in the wrong order. (The correct order is 
visual effect dissolve slowly.) It you wrotc this command, 
you would see a ''Cant understand" dialog box like this: 



Can't understand orguatnts of eoMand 
visual. 

[ Scripj ] f Cancel 



Figure 1-10 A Xan'i understand" dialog box 

Clicking Script in a "CaiVt understand" dialog box opens the script 
editor and places the insertion point in the statement HyperCard 
can't understand. You can then correct any errors tn syntax or 
spelling and try your script again. 
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The syntax ofa HyperTalk statement describes the general, 
underlying structure lhat a statement must follow. In order for 
HyperCard to understand a statement, it must contain the correct 
elements in the correct order. Certain conventions are used to show 
the syntax of HyperTalk statements. For example, here's the syntax 
of the visual command; 

visual [effect] effectNamc [speed] [to image] 

Syntax elements in this kind of type are typed exacdy as they 
appear. 

Element;; in italic are placeholders. In an actual statement, you 
wotdd replace effi'aNamewith die name of an aaual visual efFea, 
such as barn door close. ^ 

Syntax elements enclosed in brackets [ j are optional. {You doht 
include the brackets in an acmal command.} In the visual 
command, die elements [effect], [speed]y3nd [to image\ 
are opdonal. 

Knowing a command's syntax is as important as knowing what it 
does. But don t worry — you don't have to memorize syntax. A 
reference section, "Syntax Summaries/' appears at the end of each 
chapter in this book, describing the syntax of the commands you've 
learned. The Appendix and HyperTalk Quick Reference card list 
the syntax of every HyperTalk command. The HyperTalk IlGS 
Help stack and the HyperCard Hgs Script Language Guide describe 
the syntax of eveiy command in detail. 
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1 Litting illfOiniUtiOn So far che Collection stack consists of a single card with a Home 
into VT)Ur SUlCk '^•J^^^'^- ^^^^^ section you'll add fields to the Kickgroiind of 

the stack, type some text into the fields, and add some cards to 
the stack. 

Adding fields to the First youni add four fields to the background. When you re 
background finished, the background will look similar to this: 



Arti-sr lieid 
Titlt' field 




Figure 1-1 1 Background fields for [he Collection siack. 

Bccatise you'll place these fields in d^e background, they will appear 
on every card in your stack. However, die text contained in the 
fields can be different on every card. 



Creating the Category field 

You can always get a new field by choosing New Field from the 
Objects menu. In this book you'll use a keyboard shortcut to make 
fields. 

Follow these steps: 

1. Press " -B to work in die background. 

The word Baikgtvu fid appears in the menu bar. 
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The Field tool 



2. Choose the Field tool. 

The pointing hand (Browse tool) on the screen changes to an 
arrow pointer. 

3. With the pointer anywhere on the card, hold down the .! k^. 

The arrow pointer changes to a crosshair. 

4. While holding down the Cl^ key> press the mouse button 
and drag to create a new field one line high and about three 
inches wide, 

This method for creating a field is similar to the method you 
used to create your Home button. Release the mouse button and 
the key when the field is the size you want. The new field is ^ 
automatically selected, as indicated by die "marching ants" 
around it. While it's selected, you can stretch or shrink die field 
by dragging a corner. 

5- Move the field to the top of the background (as shown in 
Figure 1-1 1). 

To move the field, position the pointer near the center of the 
field and drag. Because the field is in the background, it will 
appear in this position on every card in the stack. 

6. Double-click the field to see the Field Info dialog box. 

Or choose Field Info fi-om the Objects menu. 

HyperCard fields have a variety of styles and teatures fi-om ^ 
which to choose. You customize a field s appearance and actions 
through the Field Info dialog box, 

A vertical bar marks the insertion point in the Field Name box, 
ready for you to type a name. 
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FitltfHoBf II ~ 
Bkgnd fie]d nmber: 1 
niock Ted 

□ ftutoTob 

□ Don't Search 
IZI Shared Text 

QontT) 



BkgndtipldlD; I 
Style: I irgnsporgnt-^ 



O Show Lin«$ 



Pop-up menu for ctiooslng 
a field's style 



Figure 1-12 The Field Info dialog box. 



7- Type category to name the field (but dont press Retum). 

8, Choose "rectangle" from the pop-up menu to set the field's 
style. 

9. If you*d like, choose a font fijr the field. 

Click the Font button to display the Text Style dialog box. Then 
choose a font and size. (Choose a font chat s easy to read, such as 
Shaston 8.) When youVe selected a font» click OK to return to 
the Button Info dialog box. 

10. If you*d like, choose colors for the field. 

Click the Colors button to display the Field Color dialog box. 
Then choose a color for the frame of the field and the text inside 
the field. When you've selected the colors yoti want, click OK to 
return to the Field Info dialog box. 

11. Click OK to close the Field Info dialog box. 
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Crcalirif^ tii(^ Artist. Tide, and Notes fields 

Now you need to add diree more fields to the background- This 
time you'il use a shortcut to create each field. Make sure you're srill 
in the background and that the Field tool is still selected, then 
follow these steps; 

1 . While holding down the Option and Shift keys, position die 
pointer near the center of the Category field and drag down. 

You should see an exact duplicate of the Category field move 
down the screen, leaving the original Category field in place. 
Drawing the field while you hold down the Option key creates 
an exaa duplicate of the field. Drawing the field while you hold 
down the Shift key restricts your movement of the field to 
straight up and down or straight left and right. Dragging the V 
field while you hold down bodi keys produces both efi^eccs 
simultaneously, (Both of these shortcuts aJso work for buttons^ 

Now all you need to do is change the name, and you'll have a 
new field with the same size and other characteristics as die 
Category field. 

2. Double-click the new field to see its Field Info dialog box, and 
name the field Artist 

Except for its name, number, and ID, the Artist field will have all 
the same characteristics as the Category field. 

3. Using the same shortcut, Opdon-Shift-drag the Artist field to 
create a third background field, and name it Title ^ 

4. Oprion-Shift-drag the Tide field to create a foiuth background 
field, and name it Hotes 

In addition to changing the name of this field, you should 
change the field's style to "scrolling." After you rename the field, 
enlarge it by dragging a corner, until it s a few inches high, as 
shown in Figure 1-11. 
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ping in the fields Now that youVe created all the fields for your stack, you're ready to 

type some text into them. Figure 1-13 shows some examples of 
cards with text typed in the fields. For your own stack, type in 
information about your own records^ capes, or compact disks. 



1 RripicU? 

i| ^inruria in G Ha l6 i^iJ 

a ihrrplJg<Si>ltlii6riirf __ 



l.tlQFmiL fof IrooBlr H it 

3. Rd^edf^ rdtfiily 330 
H Tnlt iDKin FrHth IIS 
5, Sibling amVln^iU 



Pnn Hflrtti 



Figure 1-13 Sample record cards 
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To type rext into the fields, follow these steps: 

1. Choose the Browse tool. 

Choosing the Browse tool automatically takes you our of the 
background. In this case, it takes you to the first and only card in 
the stack- 

2. Click inside the Category field and type the category of music 
to which the recording belongs. 

Type "Rock," "J^> " "ClassiGil," "Country," or any other 
category you wanf to use. Don t press Return. 

3. Press the Tab key. 

The insertion point moves to the next field you created — in chi^^ 
case, the Artist field. 

4. Type the name of the artist featured on the recording. 

Type the name as you would like it to be sorted alphabetically. 
For example, if you want your cards to be sorted by the anist's 
last name, you should enter "Johann Sebastian Bach" as "Bach> 
Johann Sebastian." 

5. Press die Tab key to move to the Tide field and type the tide of 
the recording. 

6. If you'd like, press the Tab key to move to die Notes field and 
type the names of songs or any other information you want to 
keep about the recording. ^ 
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AddinfJ more cards Now add at least cwo more cards to the stack. Follow these steps: 

to the stack ^ ^^^^^^ ^^^^^ C^^^^ j^.^ ^^^^^ 

Or press ^ *^-N. A new card appears on die screen. 

*> !f a field dmppeim when you create a new card: You may have 
placed die field in the card layer rather than the backgrotind 
layer. To move a field from the card layer to the backgrot;nd, go 
back to the card where you last saw die field; dien click the field 
with the Field tool to select it. Press C^-X to cut the field, press 

to go to ihe background, and press "^-V to paste the field in 
the background, (You'll also have to return to the card layer and 
retype die contents of the field.) 

2. Type information about anodier recording into the fields on 
die new card. 

Repeat dicsc steps to add as many cards as yotj want Co your stack. 



Buttons for traveling Now that your stack contains several cards you'll create two buttons 

that allow you to move fonvard and backward between cards. 

Creating Next and To make die buttons, use the sajTie steps you followed when you 
Previous butloas made die Home button: 

^ 1. Press ' to work in the background. 

The word appears in the menu bar 

2> Choose the Button tool. 



Chapter 1: Gelling Started 



29 



3. While holding down die key, drag to create two new 
transparent buttons. 

Make each new burton abour the same size as the Home button, 

4. Position the two new buttons side-by-side, near the Home 
button. 

Drag each burton by its center to move it. 

Customizing the button on the right 

Make the button on the right into a Next button: 

1. With the Button tool still selected, double-dick the button on 
the right. ^ 

The Button Info dialog box appears, 

2. Name the button tJext. 

3. Click the Icon button to see the available icons. 
4' Choose any icon that points to the right. 

Click the icon you want. 

A rig hi 

arrow icon 5- Click OK to close the list of icons. 

You see the Button Info dialog box again. 

You want the Next button (the button on the right) to take you to 
the next card in the stack. Put your instructions into the buttons g 
script now, " 

6. Click the Script button to see the script editor. 



7. Type the following script {pressing Return at the end of 
each line), 

on mouseup 

visual effect scroll left 

go to next card 
end mouseup 

8. Click OK. 

The script editor disappears. You should see the icon you chose 
on the button. 

Now cry out the Next button to see how it works. 

9. Choose the Browse tool and click the Next button. 

Each rime you click the button you go co the next card in 
the stack. 

You can use the Next button to move forward diroLigh the cards in 
the Collection stack. Cards in a stack are arranged in a circle, so the 
first card is the nexr one after the last card. 

CLlstomizi^^^ the bunon on tlie left 

Make the button on the left a Previous button: 

1. Choose the Button tool and double-dick the button on 
die left. 

The Button Info dialog box appears, 

2. Name the button Previous 

3. Click the Icon button to see the available icons. 

4. Choose an icon that points to the left. 

If s best to use the same kind of arrow that you chose for die first 
button, but pointing the opposite way. 
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5. Click OK to close the list of icons. 

The Button Info Julog box appears again. 
Now you'll wrire a script for the Previous button, 

6. Click Script to open the script editor and type the following 
script: 

on mouseup 

visual effect scroll right 

go to previous card 
end niouseUp 

7. Click OK, 

The script editor disappears. You should see die icon you chose 
on [he button. ^ 

8. Try out the Previous button. 

Choose the Browse too! and click the Previous button. Each time 
you click die button you go to the previous card in the stack. 

Moving to adjacent cards isn t the only possibility, of course; you 
can create other buttons to take you to any card of any stack you 
want by specifying in a script where yoti want to go. 



Adding graphics If you'd like to give your stack a disrinctive look, you can take .some 

time now to design graphics for the background. Well-designed 
graphics can make your stack easier to use, as well as more appealing' 
visually. 

You can create graphics by using die Paint tools, or you can copy 
clip art from the Art Ideas stack. You may also want to change the 
fonts in the bacl^round fields or the position of the fields and 
buttons. You'll be adding more buttons to the background later, so 
be sure to leave space for them. 
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The Paint ioo\s- 
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(For instructions on how to use paint tools, see the HyperCard UVS 
Reference. For tips on how to design stacks, see HyperCard Stack 
Design Guidelines, published by Addison- Wesley.} 

You can leave your stack as it is, copy one of the designs suggested 
in Figure 1-14, or have fun creating a design of your own. When 
youVe satisfied with the way your stack looks, you can move on to 
Chapter 2. 





Figure 1-14 Someposstlilcdesign.s 
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What youVe 
done so far 



In this chapter youVe created a stack in which you can practice 
scripting in the rest of this book. YouVe created fields and added 
cards to the stack, YouVe also created some buttons and written 
their scripts. 

Here s a list of the HyperTalk words you have learned: 



Keywords 



on 



end 



System Messages 



tnouseUp 



Commands 

go 

visual [effect] 



This word signals the beginning of a set of 
instructions. It must be followed by ilie name 
of a message, such as mouseUp. 

This word signals the end of a set of 
instructions. It must be followed by the narr^ 
of a message* such as mouseUp. All HyperTalk 
message handlers conclude with an end 
statement. 



When you click something, such as a bunon 
on the screen, the system sends mouseup 
when the mouse button is released. (If the 
pointer is moved off the screen button before 
the mouse button is released, mouseUp is 
not sent.) 



This command is used to move from one 
card to anodier, within a stack or between 
stacks. 

Causes the visual effects you specify. A 
visual command must eventually be 
followed by a go command. 
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ax summaries i iit^ following reference section describes the basic structure of the 

two HyperTalk comtriijnds yoti've learned so far. 



Go The go command takes you to the specified card or stack. If you 
name a stack without specifying a card, you go to the first card in 
the stack. If you don t name a stack, yoti go to the specified card in 
the current stack. You can specify a visual effect co be used on 
opening the cud by using the visual comniLUid before you use rhe 
go command. 

Syntax 

go [to] sktck 

go [to] i/iitkgmund [of stack] 

go [to] card |of hackground] [of stack] 

The words stack background, and card-^^ placeholders- You would 
replace diem widi a word or phrase that describes a stack, a 
background, or a card. 

Examples 

go "Home" 

go to first card 

go to card 3 of background 2 of "Presentation" 
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Visual The visual command lets you display visual effects while going 

from one image to another The visual command must eventually 
be followed by a go command. 

Syntax 

visual [effect] effictName [speed] [to iTnage] 
EffectName is one of the following: 



barn door close 
barn door open 
checkerboard 
dissolve 
fade 

iris close 
iris open 
plain 

scroll down 
scroll left 
scroll right 



scroll up 
Venetian blinds 
wipe down 
wipe left 
wipe right 
wipe up 
zoom close 
zotmi in 
Eoom open 
zoOTi out 



Speed 'is one of the following: 



fast 
slow [lyj 



Image is one of the following: 



black 
card 

color number 



very fast 
very slow[ly] 



gray 

inverse 

white 



Note: w^w^'^ is a number between 1 and 16, representing one of 
the colors in the color palette. 

Examples 



visual effect barn door open 
visual dissolve slowly to white 
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Claapter 2 



Fields and Other Containers 



I 



n everyday life a container is something you can put tilings into. 
In HyperTalk a container \s a place in the computer's memory 
where you can put a valu^such as a number or some text. You can 
put values into containers; you can also get values our of containers 
to use elsewhere as needed. 

In this chapter you'll learn about three different kinds of containers: 
the Message box. fields, and variables. You'll also learn how you can 
use scripts to work with values in containers. YouMl add some more 
features to your Collection stack, and you'll increase your 
vocabulary of HyperTalk commands. 

if you took a break at the end of the previous chapter, start up 
HyperCard and go to the Collection stack before you read on. 
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Putting values 
into containers 




You use che put conim;ind co put a value into a concaincr. In this 
section, you'll practice using the puL command to pur values into 
the Message box. Later in this chapter you'll use chc puL tonim;.uid 
in scripts. 



Putting values into 
the Message box 



First open the Message box, 
1. Press -M to open the Message box. 
Or choose Message trom the Go menu. 

The vertical bar that marks the insertion poinr should be inside 
the Message box, ready for you to type. If for any reason you 
previously typed something into the box, the earlier entry will 
still be there. When you start typing, whatever you type will 
replace the old text. 




Figure 2- i Tlu- Mi's.'i^ijjc ixix 
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2. Type fiiJi. "ik:iJu" iiiLu Lhc: mcLiL; jtjij aiid press Rctiim. 

The word Hello appears in die Message box. 

The put command does what you wouJd expect — ic puts a value 
where you want it to go. In its most bisic form, the syntax oi the 
put command is; 

put expression [into container ] 

The placeholder expression is a word or phrase diar specifics a value. 
For example, the expression 2 + 2 specifies the value 4. 

The placeholder containeram be a field, a variable, or the Message 
box. If you don i: specify a container, the value is pur into the 
Message box. 

* By the way: After you press Reairn, you can start typing a 
new message into che Messi^e box right away, even though 
you can t see the vertical bar. Whatever you type will replace 
the old text. ■> 

3. Type put "The time is" 5.5. the time and press Return. 
Some text appears in die Message box. For example: 

The time is 12:00 PM 

Including quotation marks around text characters rells HyperTalk 
to interpret literally whatever is inside. It treats what's inside the 
quotation marks as a string of text characters. 
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If you don I include quotation marks, HyperTalk eviilu.ncs the 
expression. That is, it replaces the expression with the value oji\\z 
expression. For example, it replaces the time with the time 
currcndy set in your Apple IIcs. 

The double ampersand (it) joins two pieces of text together wiih a 
space in berween. In this case^ it joins die words the mme is and 
the current system rime, (If you wanted to join cwo pieces of text 
together without a space, you would use a single ampersaiidj 

4. Close the Message box. 

Click the close box in the upper-left corner, or press " -M. 



FieMs as containers Fields are objects. They can receive and send messages and 

can have scripts. Fields are also containers that can hold text 
and numbers. 



Putting values into a field in Chapter l you pur text into fields by typing in die fields. In diis 

secdon you'll write a script diat puts text into a field. 

First you need to create a background field named Label. This field 
will display the number of each card in your stack, so you can easily 
tell where you are in the stack. 
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Creatinj^ liic Libel field 

To create the field, follow chese steps: 

1. Press ■ ' -B to work in the background. 

The word Backgrounei appears in the menu bar. 

2. Choose the Field tool from the Tools menu. 

3. Hold down the ' key and drag to create a field one line high 
and about an inch long. 

Move the field to any available space in the background by 
dragging its center. 

4. Double-click the field to see its Info box. 
Or choose Field Info fi"om the Objects menu. 

5. Name the field Label and set the fields characteristics. 

Choose "rectangle" for the field's style. If you'd like, specify the 
field s font and coiors. 

6. Click OK to close the Field Info dialog box. 

Writing a saipl for tiif background , 

You could label all cards in your stack by going to each one and 
typing its number into the Label field. But you can also write a 
script telling HyperCard to do it for you. 

You'll write a script that puts a description of each card into the 
Label field. The field will contain a text string with two pieces: che 
word Card and the number of the current card. 
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To write die script. foII<iw these seeps: 

!. Choose Blignd Info from the Objects menu. 

The hito di;ilog box ior the background appears. 

2, Click the Script button. 

The script editor for the bacl^round appears. The line ar die top 
of the script editor identifies it as the background script, 

3- Type the following script: 

on openCarci 

put "Card" ss number of this card into background field "Label" 
end openCard 

In English, the script says, "When a card opens, put the word ^ 
Card and the number of the card into the background field 
named Label. That s all." 

4. Click OK. 

5- Try out the script by choosing the Browse tool and clicking the 
Next button several rimes. 

Each time you go to another card, you shotdd sec in the Label 
field the word Card followed by the number of the current card. 

❖ If something else happ^jed- Open the bacl^ground script and 
check it for spelling errors. Also make sure that the Label field is 
in the background and that its name matches the name you used 
in yoursciipi. <* _ 
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iiow thusL'dpl works 

Just us HyperCard sends the system mess^e mouseup every dme 
you dick the mouse burton, it sends the message opencard every 
rime you go to a different card in a si^ck. When you open any card 
in the Collection stack, the opencard message handler executes and 
puts the number of die current card into the Label field. Because 
the openCard handler is in the script for the background, it affects 
every card sharing this background — not just a particular card. 

The advantage of using a script to label cards is that you wont have 
to worry about labeling the cards yourself even if you add or delete 
cards. HyperCard will take ciire of it for you. 



Script editor tips 

As you be^n to write longer scripts, you'll find it helpful to know 
the keyboard commands for cutting, copying, and pasting text in 
the script editor: 



Key combination 
Option-Remrn 



Action 

Copies the selected text to die Clipboard. 

Cuts the selected text to the Clipboard, 

Pastes the contents of the Clipboard at the 
insertion point. 

Breaks long statements into more than one 
line (so that they will fu in the script editor 
dialog box}. Pressing Option-Return inserts a 
"soft" Return character ar the end of a line, 
symbolized by this character (-^), in your 
script. 



The Appendix and the HyperTalk Quick Reference Card contain 
complete lists of keyboard shortcuts you can use while working in 
the script editor. 
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Creating a pop-up field Now it s rime to give yourself a wcll-dcserved pat on the back; you'll 

create a field that displays the credits for your stack. You'll create a 
button that makes the field appear, and write a script that makes the 
field disappear when you click it. 

Figure 2-2 shows an example of how the new field and button 
might look: 



Roeh 



urrsT 



TIRF 



Sound Mvht 



HOTES 



1 BlLPprinlfor Troubl? W 
?.lDtii]|i|Gr?t]l 7 1^ 
J.Rmcir'iFtirU^ 3:311 



RECORD 
CQLLECTIQH 



This slflct scripted 
riE! 



Credits field 



Figure 2-2 A sampte Credits field 
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You cin start from any card in rhe Colleccion stack. Create the field 
by following these steps: 

1. Press 'B to work in the background. 

The word Background/ appt^ais in the menu bar. 

2. Create a new field. 

Use any method you want. Make die field about two-inches 
long and an inch high. Its okay if die field covers other fields 
or burtons. 

3. Double-click the field to see its Info box. 

4. Name the field Credits 

5- Click Shared Text. 

Background fields with shared texr contain the same text on 
every card. 

6» Choose ''shadow'* from the pop-up menu to set the field's 
style. 

7. If you want to, choose a font and colors for the field. 

8. Click OK Co close the Field Info dialog box. 

Now you'll type your message in the field. Because i: s a 
background field with shared text, the message you type will 
appear on every card in the stack. 

9. Choose the Browse tool. 

1 0. Click inside the Credits field to see the inserdon point, then 
type the credits for your stack 

Type any message you want. 
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Mjkinji iiii Al>uiil I his Slack hullon 

Next you'll create a hiittnn that makes the Credits field appear and 
disappear. Make siire you're still working in the background, and 
follow these steps: 

1. Choose the Button tool and create a new button about an inch 
wide and one-half inch high. 

Drag the button to any available space in the background, 
2» Double-click the button to see its Info dialog box, 

3. Nanie the button About This stack and select Auto Hilite, 

4. Choose "rectangle" for the button s style. 

5. If you want to, choose a font and colors for the button. ^ 

6. Click Script to see the script editor and type the following 
script: 

on mouseup 

show tag field "Credits" 
end mouseUp 

The letters bg are an abbreviation for the word background. The 
appendix includes a complete list of HyperTalk abbreviadons. 

[n HyperTalk, you muse use card or cd in front of field to 
specify a card field. If you leave out card, HyperCard assumes you 
mean a background field. Conversely, you must use background, 
bkgnd, or bg in front of button ro specify a background button, ^ 
otberwise HyperCard assumes you mean a card button. To avoid 
confusion, it's a good idea ro always use card or background when 
referring to fields and buttons, 

1. Click OK. 



\Vrii!!i_tT :i saipi lor ihu Cralils lldd 

Next yoLill write a script that make.-i rhc Credits field disappear 
when you dick it. 

1. Choose the Field tool and double-click the Credits field to see 
its Info box. 

2. Select Lock Text to lock the field. 

When a field is locked, you can t type in the field. CYou have co 
unlock [he field if you want to type in it.) 

When you elicit a locked field. HyperCard sends mouseup and 
other system messages to the field. 

3. Click Script. 

The script editor fur the Credits field appears. 

4. Type the foUowing script: 

on mouse Down 

hide me 
end mouseDown 

MouseDown IS a system message that's sent as soon as the mouse 
button is pressed. 

The Hyper lalk word me refers to the object in whose script die 
word appears. In this case, me refers to the Credits field, 

5. Click Olv. 
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Trying ouE [lie scripts 

Now see how the Abouc button and Credits field work. 
L Choose the Browse tool and click the Credits field. 
The field disappears. 

2, Click the About This Stack button. 
The Credits field reappears. 

•> If something ebe happened: Make sure the script for the burton is 
spelled correcdy. Also make sure that the name of die Credits 
field is spelled correctly. 

If the Credits field still wont appear when it is supposed to, open 
the Message box and type: show last bg field. Then check d^ 
spelling of the Credits field name in the Field Info box. 

3. Click the Credits field to make it disappear. 

How iht: scripts work 

When someone clicks the About This Stack button, the mouseup 
himdier in die button's script executes. The statemenr, show bg 
field "Credits" makes the Credits field visible. 

When you press the mouse down when the cursor is in the Credits 
field> the field's mouseoown handier executes. The statement hide 
me makes the Credits field disappear. 

To be able to send messages to a field by clicking it, the field must ^ 
be locked. Otherwise, clicking the field merely places the insertion" 
point inside the field. 

You can use the hide command to hide a field, a button, a window 
(sucli as the Message box), the menu bar, the background picture 
(graphics in the background), or the card picture (graphics on the 
card that arcnt in the background). The r^ihow command does jusr 
the opposite; you tise show to reveal hidden elements. 
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Variables 



A variabU is a niimed container thai can have any value you choose 
CO pur into it. in this scaion you'll create a button chat uses a 
variable in its script. 



Creating a Sort button First you'll create a button that sorts all the cards in your stack 

alphabetically. When a user clicks the Sort button, a dialog box will 
appear asking the question "Son by what?" and presenting three 
possible replies: Category, Tide, or Artist, When the user chooses, 
die stack is sorted alphabetically according to the contents of the 
chosen field. 

Follow these steps to create the Sort button: 

1. Press ' -B to work in the bacl^ound. 

2. Choose New Button from the Objects menu, 

A new button appears. When you choose the New Button 
command, you automatically switch ro the Burton tool, and the 
new button is automatically selected. 

Drag the button to any available space in the background, 

3- Name the button Sort. 

The Show Name and Auto Hilite options are already selected. 

4. If you want td choose a font and colors for the button. 

5. Click Script to see the script editor and type the follovnng 
script: 

on mouseUp 

answer "Sort by what?" with "Category" or "Title" or "Artist" 
put it into reply 
sort by background field reply 
end mouseUp 

6. Click OK. 
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Nijw 117 lIic Son l)Liiiuii lu scl- how ir work*^: 
7. Choose the Browse tool and click the Son button. 
The following dialog box appears. 



Sort biiL^fiat? 



[category] [ Title ] | pflrtiu 



Figure 2-3 Uialo^ bfix dispbyal by Son hulU3n 

8. Click Artist. ^ 

HyperCard reorders the cards in die stack alphabericolly 
according to the contents of the Artist field. Browse through 
your stack with the arrow buttons to see that die names ol the 
artists are in alphabetical order 

If you would radier sort your cards by category or tide, you can use 
the Sort button to do that, too. 



How ihu script works 

The answer command 2sks the user of your stack a question, and 
presents up to three possible replies in the form of buttons in a 
dialog box. In this case it asks the question sort by what? and 
presents diree possible replies: Category, Title, and Artist. (Th^ 
answer command always highlights the last reply, so it's a good idea 
to list the safest or "'most correct" answer last.) 
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When someone clicks a reply in the dialog box, [hat reply is pur 
into a special HyperTalk variable named it . For example, when 
you click Arrisr. die value Artist is put into it. 

The next statement in the script, put it into reply, puts the 
contents of it into another variable, which you ve named reply. 
The names of variables can be almost anything you choose, but it's 
a good idea to name them something thai describes what's 
contained in them. 

If you clicked Ardst, the variable reply would then contain the 
value Artist . Therefore, the statement 

sort by background field reply 

is eviduated as 

sort by background field Ajrtist 

and HyperCard sorts all the cards in your stack according to the 
contents of the Anist field. 

o Local versi4S global: The variables discussed here are local 
variables; that is, they and their values exist only within the 
handler in which they* re created. HyperCard also has global 
variables^ whose values are available to all handlers everywhere. 
You declare a variable as a global variable by using die global 
keyword. For information about global variables and the global 
keyword, see the HyperTalk IIgs Help stack or die HyperCard 
1 Igs Script Language Guide. *> 
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IHitting comments in \.\\^ handler 

The following version of the handler for rhe Sort button shows 
comments that describe the action of the handler's scarements. 
Comments arc text lines typed into a script that are not pari of the 
instrucrions. In HyperTalk^ a comment must be preceded by a 
double hyphen (~); a double hyphen indicates to HyperCard that 
the text following is a comment and should be ignored. 

You don r have to type these corrunents into your own scripr; they 
are shown for example only. 

— This button sorts the stack according to a field chosen by the user 
on mouseUp 

answer "Sort by what?" with "Category" or "Title" or "Artist" 
— The user's response is now in the variable it ^ 
put it into reply — Response is now in reply 
sort by background field reply — Sorts the stack 
end mouseUp 

As you see, comments can be placed either ac the beginning of a line 
or after a statement. 

Although HyperCard ignores comments, other scripters generally 
appreciate diem. Adding comments to your scripts is an excellent way 
to document what your scripts do. Comments nor only help odier 
scripters iniderstand what youVe done, but also help you remember 
when you look at old scripts long after you Ve written them. 



Chapter 2- Fields and Other Containers 



What you've done YouVc (earned how to use fields, variables, and rhe Message box as 
in this clltipter ^"**ncaincrs for text and numbers. 

You've also added some features to your Collection stack: a handler 
that automatically numbers the oirds in the stack, a pop-up field, 
and a Sort button. 



System messages 
openCard 

mouseDown 

Commands 

answer 



hide 



put 



show 



sort 



A me,ssage sent by HyperCard when a card 
is opened. 

A message sent by HyperCard when the mouse 
button is pressed down. 



Puts a box on the screen containing a question 
and up to three response buttons. 

Makes buttons, fields, windows, and picuires 
invisible. 

Takes something and puts it somewhere. The 
word put must be followed by the name of the 
thing you want to put somewhere and the name 
of the place where you want to put it. 

Causes hidden buttons, fields, windows, and 
pictures to become visible. 

Sorts all the cards in a stack. 
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operators 

& (Ampersand) This symbol joins two pieces, or 

srrings, of text together with no space between 
them, 

6& (Double ampersand) This combination symbol 

joins two pieces of text with a space between 
them. 

("Soft'' return character — produced by pressing 
Option-Return at the end of a line) Breaks long 
statements into more than one line in the script 
editor window. 

(Double hyphen) Indicates chat what follows is 
comment and should be ignored by HyperCard.^ 

Script editor 
keyboard commands 

r. - C Copies the selected text to the Clipboard 

r - X Cuts the selected text to the Clipboard. 

' V Pastes the contents of the Clipboard at the 

insertion point. 

Miscellaneous 

bg Abbreviation for background, 

me The object in whose script die word appears. ^ 

it The name of a special HyperTalk variable. Certain 

commands, such as answer, put a value into it. 
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lIX SUmnittl ICS vim section describes the synciix of the commands you Lised in this 

chapter. 



AnSWt^r The answer command displays a dialog box with ii question and 

up [o three buttons for the user to choose from, each representing a 
dirterent reply If you don t specify a reply, HyperCard displays a 
single OK button in the box. 

HyperCard puts die label of whatever button gets clicked into a 
variable named it. 

Syntax 

answer question 

answer question with reply 

answer question with replyl or reply! 

answer question with replyl or reply2 or Teply3 

Qitestion can be any text you like — usually a question that invites 
the user to ans"wer- Replyl, replyl, and replyi are the labels for 
buttons representing the choices. The size limit for a reply is about 
1 1 characters, depending on the width of the characters. 

Example 

answer "Pick a color:" with "Red" or "Blue" or "Green" 
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1 lidt^ The hide command makes invisible a burton, field, picture, or 
window. (Sec also "Show," later in this secdonj 

Syntax 

hide button 
hide field 

hide card picture 
hide picLure of card 
hide background picture 
hide picture of background 

hide menuHar 
hide message box 
hide tool window 

hide pattern window ^ 
hide go window " 
hide card window 

Button, field card, and backgrounds^ expressions identifying 
objects {for example, background button 1.) 

Card pi cture conslsts of all elements on the card level created with 
a Paint tool. Background picture consists of aJl graphic elements 
on the background leveh 

Examples 

hide background field "Credits" 
hide picture of card 1 
hide message box 
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The put command places rhe value of an expression into 
a contaitier. 

Syntax 

put expression 

put expression into [chunk of] container 
put expression after [chunk of] container 
put expression before [chunk of] contains 

Expression c^ be any description of a text string or a number. 

C/;W^ consists of rhe words character, word, item, or Line 
preceded by an ordinal or followed by a number, range of numbers, 
or another chunk expression. 

Container is an expression that idenrifies a field, a variable, rhe 
Message box, or the selection- If you don't specify a container, 
container '\s the Message box. 

The preposition into causes anything already in the destination 
container to be replaced by the expression. The preposition before 
places die expression at the beginning of what s in the container (if 
anything), and after puts the expression at the end. 

Examples 

put 255 

put 256 into Total 

put 256 into line 1 of card field 3 

put 25& before word 4 of line 1 of card field 3 

put 256 after word 3 of line 1 of card field 3 
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Show The show command nvAca visible ii button, field, picture, or 
window. 

Syntax 

shov^ button I at /rvhri] 
show Jt^//:i [aL point] 

show card picture 
ahow picture of carfJ 
show background picture 
show picture of background 

show meniiBar 

show message box 

show tool window [at point] 

show pattern window [at point] 

show go window [at point] 

show tjard window 

See "Hide." earlier in thii section, for a description of the 
placeholders. 

P;^/>7r consists of the horizontal and vertical coordinates of a point 
on the screen, separated by a comma. This optional phrase, at 
point, lets you place a button or field wherever you want. If you 
don t include it, the window or objecr appears wherever it was 
before it w^is hidden. 

Examples 

show background field "Credits" 

show background field "Credits" at 10,20 

sht^w Message box 

show picture of card 1 
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I'ht: sort command allows you to icoidcr ail die cards in a stack 
horn within a script. 

Syntax 

sort [sortDirt'ctinn] [sorlStyie ] by fxpresstrw 

SortDirection IS ascending or descending. If you don i specify a 
direction, rhe direction is ascending, ^t^rf^r^/f is text, numeric, 
daLeTime, or inter national. If you don't sptxify a Style, the style 
is text. 

Expression is any expression. The sort command orders dl the cards 
in a stacit according to the vaJue of expression, which is evdiiared 
individually for each card in the stack. 

Examples 

sort by card field I 

sort descending numeric by card field 1 



Cliiipier 2: Fields and Oiher Containers 



59 



Ghapter 3 



Scripts That 
Make Decisions 



I 



n this chapter you'll learn how to control which statements are 
executed in a message handler, as well as the order in which rhey are 
executed. You'll create some buttons for your Collection stack and 
write scripts that use the HyperTalk words if and repeat. By 
using if and repeat you can write scripts that are more responsive 
and efficient. 

It you took a break at the end of Chapter 2, start up HyperCard 
and go to the Collection stack before you go on. 
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True 



It Structures in English, we use the word if\o ralk about an action tliat depends oj 
a certain condirion. For example, we might say "If I am hungry, rhen 
rU ear dinner." If the condition "I am htmgry'^ is true, then the ac|p|i 
*'ril eac dinner" will be pertormed, 

!n HyperTalk, the word if is used in much the same way if and 
then art HyperTalk keywords chat work Together in arrangen^ents 
called if structures, if srructures are used to tesi conditions and 
specify different actions, depending on the results. 

If strucmres come in a few varieties; the most basic version is: 



if condhion then 

action 
end if 



The placeholder condition stands for the diing being tested, h's 
an expression diat HyperCard can evaluate as eitlier true or false, Tht 
placeholder action stands for the insrrucnon lines that follow ^ 
if the condition is true. The last line, end if, signals the end of the 



instrucuons. 



Here s how the English example would look if it could be written in 
HyperTalk: 



if 1 am hungry then 

I'll eat dinner 
end if 
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(hi F.nt^lish. flic wiU'd thni \s olccn iniplit-J; in HyperTalk you must 
iilwiiys ijKludc it.) 

Creating a Quit button In this seaion youll create a burton that uses an if structure in its 

script. When you click die button, a dialog box will appear asking 
you whether you want to quit HyperCard. The dialog box will 
display two options: OK and Cancel. If you click OK, you quit 
HyperCard, It you click Cancel, the dialog box disappears and 
nothing else happens. 

Follow these steps to make the Quit button: 

1. Press to work in the background. 

2. Select New Btinon from the Objects menu> and move the new 
button to any available space in the background. 

3. Name the button Quit and select Auto Hilite. 

4. If you want to, choose a font and colors for the button. 

5. Click Script to see the script editor, and type the following 
script: 

on mouseup 

answer "Quit HyperCard?" with "QK" or "Cancel" 
if it ia "OK" then 

doMenu "Quit HyperCard" 
end if 
end mouseup 

Notice that the concents of the if structure are automatically 
indented. The statements beginning with if and end if 
should always line up. If diey dont line up, you may have 
misspelled a word or left out something. 

6. Click OK. 
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Trying uut ihc Quit button 

Now try the Quit button to see how it works; 

1, Choose the Browse tool and click the Quit bunon. 

This dialog box appears: 



QuitHyoerCard^ 

[ OK ] ^ CcnccJ J 
Figure 3- 1 Hiulog liux displayed hy the Quii button 




2. Click Cancel. 

The text string Cancel is put into the variable it. 

Because the condition it is "OK" is not true, HyperCard 
doesn't execute the action specified within the if structure. The 
dialog box disappears, and nothing else happens. 

3. Click the Quit button again. 

The dialog box appears again. 

4. Click OK. 

The text string uk is put into the vari:ib!e it. 

The condition it is "ok" is true, so HyperCard executes the ^ 
statement within the if structure — and you quit HyperCard. 

The doMenu command lets you execute any of HyperCard's menu 
commands from within a script. In this case it executes the Quit 
HyperCard command. (Be sure to put quotes around rhe name of 
the menu command.} 

To continue in this chapter you'll need ro start up HyperCard again 
and return to the Collection stack. 
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Adding an additional actitm 

An if structure can specify not only an action to be taken when a 
condition is true, but also an alternative action to be taken when the 
condition is false, if structures of this type have the general form 

if condition then 

action 
else 

anothtrAction 
end if 

In this version the placeholder anotherAction stands for an 
alternative instrucuon line or lines. An example in English might be 
something like this: "If I am hungry, then Til eat dinner; otherwise 
[else] I'Q go to the movies." Heres how it would look if it could be 
written in HyperTalk: 

if I am hungry then 

I'll eat dinner 
else 

I'll go to the movies 
end if 

Modifying the Quit button 

In this section you'll add two statements to the script for the Qui: 
button. You'll add an else statement and a statement that specifies 
an alternadve action for when a user clicks Cancel. 

L Open the script for the Quit button, 

2. Click before end if to position the insertion point at the 
beginning of the next-to-last line. 

3> Type the following lines (press Retum after each line}: 

else 

answer "Glad you reconsidered, with "No problem!" 
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The lines will automariaJly indent. When you press Return for 
the titiul time, ^?iia mcjij:ieUp should line up ut the leftmost 
margin. 

Here's the completed script {the two new statements are shown 
in boldface type): 

on mouseup 

answer "Qu;L HyperCard?" wir.h "OK" or "Cancel" 
if it is "OK" then 

doMenu "Quit HyperCard" 
else 

answer "Glad you reconsidered." with "No problem!" 
end i£ 
end mouseup 

4. Click OK, ^ 

5. Try the Quit button. 

When you click the Quit button with the Browse tool, you ger 
the alert box, just as before. Clicking Cancel (the choice 
represented by else) makes another alert box appear with a 
friendly comment and reply — ^just for fun. (No further 
instructions are specified for the "No problem!" burton.) 



liccisions within decisions 

It's possible to specify more thiui two separate actions by nesting if 
structures inside other if structures. Here's how an English 
example might look if it could be written in HyperTalk: ^ 

if r am hungry then 

if there's some food in the house then 

I'll cook 
else 

I'll order a pizza 

else 

if there's a good movie at the theater then 

I'll go to the movies 
else 

I ' li waLcli television 
end if 
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Repeat structures Repeat is a keyword that tells HyperCard to perform a command 

or series of commands over and over again. Suppose you wanted to 
create a sequence in which your stack nioved through a series of six 
cards, with a one-second pause between cards. You could write the 
instructions this way: 



go to next card 
wait 1 second 
go to next card 
wait 1 second 
gc to next card 
wait 1 second 
go to next card 
wait 1 second 
go to next card 
wait 1 second 
go to next card 
wait 1 second 



Or you could write a repeat structure, like this: 



repeat 6 times 
go to next card 
wait 1 second 

end repeat 
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Repeat sfruccurcs cause HyperCard to go around in a *'loop/' 
repeating steps Lindl a panicular cndpoint occurs. Being able :o use 
repeat Structures saves you from having to retype or duplicate 
statements over and over again. 

Repeat structures come in several variecies. The first line of 
a repeat Structure can have any ot chese general forms: 

repeat ffor) number [times] 

repeat with variable = startingVatue to endingValue 
repeat with variable = startingValue down to endingValue 
repeat until coud'tdou 
repeat while condition 
repeat [forevec] 

The statement or list of statements that you want to have repeatecj 
can follow any ot these first lines. At the end, you must include end 
repeat to indicate the end of the list. (For more information about 
variations of the repeat structure, see the end of this chapter.) 

Creating an Index butt(jn In this secrion you 11 create a button that tises a repeat structure to 

generate an index for your stack. Each index entry will include the 
name of the recording artist and the title ot the record, (Figure 3-2 
shows what the index might look like.) 

Later in diis chapter you II write a script that lets you go to a card by 
simply clicking an index entry. 
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RECORD 
CQLLECTIOK 

Ca:dl 



in del 



PULt 



Figure 3-2 A sample index card 
CrcLitiny [he Indt^x Gird 

First you need to add a new card to your stack. Make sure youVe 
looking at the Collection stack, and follow diese steps: 

1. Choose New Card from the Edit menu. 

Or press '^ -N. A new card appears, 

2. Choose Card Info from the Objects menu. 
The Card Into dialog box appears. 



Cord KoBe | 

Cof d 10. ?Lf8y Cord ntnber 31 ojt of 39 

E^Qfitoins card fields. 

Ccntains ccrd bi;ttDnt. 

nCun'tdslete 

nOon'tSeorch 

[Scnpt -] [Cplprs...] ( OK I f Cancel ] 



Figure 3-3 C;iril InFtKlMlnt; h<»x 
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3- Name the card index 

4. Click Don t Search to select it- 

When the Don r Search option is selected, HyperCard will not 
search this card when you use the find command. 

5. Click OK. 

Crt^arins; ihf Knlrics lit'ld 

Now you'll iidd a field to the Index card that will display the list of 
index entries. Make sure you are not in the background, and follow 
these steps: 

L Choose the Field took ^ 

2. While holding down the ' ' key, drag to create a large field {like 
the scrolling field shown in Figure 3-2). 

Malce the field ki^e enough to cover the Category, Artist. Tide, 
and Notes fields. 

3. Double-dick the field to see its Info box. 

Notice that the field is a card field (nor a background field}. The 
field appears only on this card. 

4. Name the field Entries 

5. Select '^scrolling ' for the field's style. 

6. If you want to, choose a font and colors for the field. ^ 
Use a small font, such as Shaston 8. 

7. Click OK to close the Field Info dialog box. 
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Creating ihf Index luiiion 

Now youH create the button that automatically generates 
the index. 

1. Press ' " -B to work in the background. 

The Index button will appear on every card in your stack, so 
make sure you see the word Bnckgrottud 'm the menu biir 

2. Choose New Button from tlie Objects menti and move the 
new button to any available space in the baclvground. 

3. Name die button Lndex 

4. If you want to, choose a font and colors for die button. 

Writing a script to go tlirough all the cards 

You will write the script for the Index button in several stages- First 
you1l use a repear structure to go dirough ail the cards in the 
Collection stack. 

Follow these steps: 

1. Click Script in the Button Info dialog box and tjpe the 
following script: 

on mouseUp 

repeat with count = 1 to the number of cards 

go to card count 
end repeat 
end mouse Up 

The contents of a repeat structure are automatically indented. 
The repeat and end repeat statements should always line up. 
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2. Click OK. 



3p Try out the Index button. 

HyperCard goes to the first card in the stack, then to the second, 
then to the third, and so on — -unnl it reaches the last card in the 
stack. 



How ihc script works so far 

The handler uses n repeat structure to go through all the cards in 
the stack. The repeaL scacemenc uses the repeal with form, 
which has this syntax: 

repeat with variable = startingNumber to endingNuynher ^ 

In this case you Ve named the variable count . The starting number 
is 1 and die ending number is the number of cards in the stack. 

The first time through the loop, count equals 1. Therefore 
HyperCard evaluates the statement 

go to card count 

as 

go to card 1 

The next time through the loop, count eqtials 2, so HyperCard 
goes to card 2 of the stack. The process continues and HyperCard 
goes to card 3, and 4, and so on — until count equals the ntimber 
of cards in your stack. At that point, the loop finishes and the K 
handler moves on to the next statement, which is end mouseup. 
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Adding siatcnienLs that compile the index 



Now you will add statements co the script rhiic pur informiicion iiuo 
the index. As you go ro each card, you'll put the contents of the 
Artist field and Tide field into a variable- Each rime the handler 
goes to another card, it will put the entry for that card aftervM^i is 
already in the variable. In this way the variable will accumulate all of 
the index entries. Finally die handler will put the contents of the 
variable into die Entries field. 

Follow these steps: 

1. Open the script for the Index button. 

2. Type the statements that are shown in bold in the following 
script; 

You'll need to break the long put command into two lines by 
pressing Option-Return after *'Title" 

on mouseup 

put entity into list 

repeat with count = 1 to the number of cards 
go to card count 

put bg field "Artist" a " " fi bg field "Title" 

£ Return after list 
end repeat 
go to card "Index" 

put list into card field "Entries" 

end. mouse Up 

Make sure everything is spelled correctly and diac the statements 
are in the right order. 

3. Click OK. 

4. Try the Index button. 

You go to the first card in the stack, dien the second, and so 
on until you reach the end of the stack. Then you go back to 
die Index card> where a list of recordings appears inside the 
Entries field. 
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If something else happened: Check your spelling and try the script 
again. Make sure chat the names of the Index card and Entries 
field arc spelled correcdy and match the names you used in your 
script, <■ 

Each index entry consists of the contents of die Arrisr field, followed 
by a few spaces and the contents of die Tide field. 

Because you put a Return character at the end of each entry, all the 
entries begin on new lines. Some entries may take up more than 
one line. Entries take up more dian one line if they are long ajid 
"wrap" onto a second line or if you typed Return characters when 
you entered text into the Artist and Tide fields. 

Some finishing touches ^ 

The index includes an entry for every card in your stack — including 
the Index card itself Because the Index card has nodiing in its Artist 
and Tide fields, the entry for the Index card is a blank line. II you 
have any blank cirds in your Collection stack, they also appear as 
blank lines in the index- 
Now you'll add an if struaore to the script that checks each card m 
make sure that something has been typed into the Artist field. If die 
Ardst field is blank, the index wont include that card. 

You'll also add a lock screen command at the beginning of the 
handler to freeze the screen while HyjicrCard goes from card to 
card ''behind the scenes." 
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Follow these steps: 

1 . Open the script for the Index button. 

2. Type the statements that are shown in bold in the following 
script: 

on ntouseUp 
lock screen 

put empty into list 

repeat with count =■ 1 to the nufnbcr tif cards 

go to card oount 

if bg field "Artist" is not enpty then 

put bg field "Artist" & " " & bg field "Title" -i 
& Return after list 
end if 
end repeat 
go to card "Index" 

put list into card field "Entries" 
unlock screen 
end mouseup 

The put statement should automatically jndenr and the if 
statement should line up with the end if statement. 

3. Click OK. 

4. Try the Index button. 

After a pause, you go to the hidex card where the list of 
recordings is displayed. The list should contain only cards for 
which you typed something into the Anist field. 

As you probably guessed, the lock screen command locks the 
screen. When you lock the screen^ the screen image won t change 
until eidier an unlock screen command is acecmed or all handlers 
have finished executing. Because HyperCard doesht liave to redraw 
the screen every time the script goes to another card in your stack, it 
can compile die Index more quickly 
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Ctcaiing a keylxiard command 

Every rime you dick rhe Index button, HyperCard recompiles rhe 
index for your stack. This process can be rime-consuming, 
especially if your stack contains many cards- Now you'll modify the 
Index buttons script so that it recompiles the index only if you hold 
down the Option key when you click the button. Otherwise you go 
directly to the Index card without compiling the index. 

Follow these steps: 

L Open the script tor the Index button> and type the statements 
shown in bold in the following script: 

on mouseup 

if the optionKey is down then M 
lock screen ^ 
put empty into list 

repeat with count = 1 to the number of cards 
go to card count 

if bg field "Artist" is not empty then 

put bg field "ArList" & " " & bg field "Title" -n 
5 Return after list 
end if 
end repeat 
go to card "index" 

put list into card field "Entries" 
unlock screen 
else 

go to card "Index" 
end if 

end mouseup 

2. Click OK, I 

3. Try out the Index button. 

When you dick the Index button, HyperCard tests the condicion 
the optionKey is down. If the Option key is pressed, HyperCard 
compiles the index. Otherwise you go direcdy to the Index card. 
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Propeities and In chis section youH write a script char lets you go to a card by 

functions ^'"^P'y ^I'^^l^'fig '^-^ index entry. To understand how the scripr works, 
you'll Hrst need to understand two important HyperTalk concepts: 
propertie.s and Functions. You'll practice using propenies and 
Rmcrions in die Message box, and then you'll write anorher script. 



Setting properties The properties of a HyperCard object are characteristics of the objea 

that you can sec. For example, every burton has a name property 
that specifies the name of the button, a style property that 
specifies the style of the button, and so on. 

Usually you set properties by choosing options in the object's Info 
dialog box or on the User Preferences card of the Home stack. But 
you can also set properties by using HyperTalk s set commani 
Follow these steps to see how: 

1. Open the Message box* 

2. Type set the hilite of bg button "Home" to true and press 
Return, 

The Home button becomes highlighted. (You might need to 
move the Message box to see it,) 

The hiiite is a property of buttons, which has a value of true 
when the button is highlighted and false when it's not. 

3- Type set the hilite of bg button "Home" to false and 
press Return. 

The Home button returns to normal. 
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The syntax of the set command is: 



sen [the] proptrty lof object^ to expressimi 

The placeholder property is a HyperCard property. What expression 
may be depends on the property. 

A complete list of properties appears in the Appendix. You can find 
detailed information about properties in the HyperTalk Help stack 
or tlic HyperCard Ihis Script Language Guide. 

Using flinclions HyperTalk contains both commands and ftmctions. A command 

(such as go or put) carries out an action, whereas a fimction returns 
a value of some sort. For example, the time is a HyperCard 
function that returns the current time set in your Apple IlGS. ^ 

To practice using some other functions, make sure the Message box 
is still open and follow these steps: 

L Type put the date and press Return. 

The date set in your Apple liGS appears in the Message box. 

Next yotf II use the ciic^tLoc ftmction (short for "click location'*), 
which returns a description of the point where you las: clicked on 



th 



c screen. 



2. Click anywhere on the screen, then type put the ciickLoc 
and press Return. 

Two numbers separated by a comma appear in the 
Message box. 
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These numbers represent the horizonral and vertical position of 
[he poinr where you last clicked on the screen. The firsc number 
celJs you how far the poinr is from the left edge of die card, and 
die second number tells you how fer ic is from the top of the 
card. The distances are measured in pixels. {A pixells the smaJlesr 
dot you can draw on the screen.) 

For example, if you clicked 20 pixels from the left edge of die 
card window and 35 pbtels from the top of the card, th^ 
clic^kLuL; would have a value of 20, y^. The valuta of the upper- 
left corner ot the screen is 0,0. 

3. Type set the location of bg button "Home" to the 
clickLoc and press Return. 

The Home button instandy moves to where you last clicked 
the mouse. 

The location is a property ofbuttons (and fields), which 
describes the location of the center of the button. In English, the 
command says: "Move the Home button so that its center is 
located where the mouse was last clicked," 

4. Close the Message box and move the Home button back to 
w+»ere you want it to appear. 

The Appendix contains a complete list of HyperTalk functions. The 
HyperTalk Help stack and the HyperCard IlGS Script Language 
Guide describe how to use each ftinction, as well as how to write 
your own functions. 
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Going from till intlcX In this scccion you ll write :i scripc that lets you go to ;i card by 

entry to :\ Circl clicking its index entry. This script is a iitde trickier thiui the others 
you've written. You'll write the script in stages to get a better idea of 
how it works. 

Go to the Index card (if you're not already there) and follow these 
steps: 

L Select die Field tool. 

2. Double-click the Entries field to see its Info dialog box. 

3. Click the Lock Text and Don t Search options to select them. 

Selecting the I.ock Text opdon locks ihe field so you can r type in 
it. When a field is locked, clicking the field with the Browse ro|^ 
doesrit place the insertion point in the field; instead it sends a 
mouseUp message to the field. 

Selecting Don t Search tells HyperCard not to search this field 
when you execute a find command If you are searching for a 
partictilar record, you would want to find the card for that 
record, not its index entry. 

4. Click the Script button and type the following script for the 
Entries field: 

on mouse Up 

set the lockText of nte to false 

click at the clickLoc 

put the selectedLine 

set the lockText of me to true 
end mousetJp 

When you're finished, press Enter to close the script editor. 
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5. Try out the script by clicking any index entry with the Browse 
tool. 

A description of the line you clicked appears in che Message box. 
For example, if you clicked die second line, che message would 
say: 

line 2 of card field 1 

❖ If something ehe happened Check your spelling and try che script 
again. Also make sure thac die Encries field is locked. ❖ 

Hf)w the script works so far 

You haven c finished the script, but here's how ic works so far. 

Because the Entries field is locked, clicking the field does not sec the 
insertion point inside the field. Instead it sends a mouseUp message 
to the field, causing the inoiiseUp handier in the field's script to 
execute. 

The statement set the lockText of me to false temporarily 
unlocks the Entries field. (LockText is a property of fields, which 
has a value of true when the field is locked and false when it's 
unlocked.) 

The next statement click at the clickLoc cells HyperCard to 
dick at the point where you last clicked the mouse. This 
temporarily places the text cursor in the line that you clicked. 

The scatemcnc put the seiectedLine pucs inco che Message box a 
description of the line you clicked. (The seiectedLine is a funccion 
that returns a description of the line in which the text cursor is 
placed.) 

Finally, the statement set the lockText of me to true relocks 
the Entries field so that it can respond to a mouseup message the 
next time you click it. 
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Finishing the script 

The script now knows which line you clicked. But what does that 
line contain? 

1. Open the script for the Entries field and type the boldface 
words in the following script; 

on mouseup 

set the lockText of me to false 

click at the clickLoc 

put the value of the selectedLine 

set the lockText of me to true 
end mouseUp 

When you re finished, press Enter. 

2. Click an index entry with the Browse tool. ^ 

The contents of the line you clicked should appear in the 
Message box. 

The value of is a function that returns the value ot any expression. 
In this case, it returns a text string consisting of the contents of the 
Une you clicked — that is, the index entry for that line. 

Now that your handler knows which recording you>e interested in, 
the next step is to go find the right card. You'll use HyperCard's 
find commiind to do that. 

3. Open the script for the Entries field, select the word put, and 
change it to rind 
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The completed script should look Hke this: 



on mousellp 

set the lockText of me to false 

click at the clickLoc 

find the value of the selectedLine 

set the lockText of me to true 
end mouseUp 

When you re finished, press Enter. 

4. Click an index entry widi die Browse tool. 

If you went to tl^e correct card, congratuladons! You're doing 
great. 

The find command tells HyperCard to search through the fields 
in the stack h^r the index entry that the user clicked. {Becatise you 
selected the Don t Search option for the Entries field, it won't search 
the Entries field.) 

❖ Ifsotnething else happened: Check your spelling and try the script 
again. Make sure that the Lock Text and Dont Search options 
are selected in the Entries field's Info dialog box. 
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What youVe done In this chapter you learned how to use if structures and repeat 
in this ChlDtCr structures, how to set properties^ and how to use functions. You 
^ added a Quie button co your stack, and you wrote a script tliac 

compiles an index for your stack, and a script that lets you go to a 
card by clicking an index entry. 

Here are the new HyperTalk words you learned. 



Keywords 

if 

then 
else 

repeat 

Commands 

click 

doMenu 
find 

lock screen 



set 



Begins an if structure. 

Used in if structures to mark the beginning of a 
list of actions to be carried our. 

Used when you want to specify an aJternative ^ 
action in an if structure. " 

Begins a repeat struaure. 



Causes the same actions that happen when you 
click a specified point on the screen. 

Lets you execute a menu command from \vithin a 
script. 

Searches al! the cards in a stack for a text string. 

Prevents HyperCard from updating the screen 
until an unlock screen command is 
encountered or until all handlers have finished m 
executing. 

Changes the value of HyperCard properties. 
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Properties 

hiiite 
location 

lockText 

Functions 

clickLoc 
date 

selectedLine 
value 



Determines whether a button is highlighted. 

Determines che location of the center of a button 
or field. 

Determines whether a field is locked. 



Returns the location where the user last clicked. 

Returns the current dare set in your Apple Ucs. 

Returns a description oi die line in a field where 
the text cursor has been placed. 

Returns the value of an expression. 
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ax SUniniciriCS THis section describes the syntax oi thu comni;inds you luitrcl iti this 

chapCLT. along wirii chcsyntLLx of rhe if and repeat keywords. 



Click The click command causes the same actions that happen when 
you click the mouse ac a specified point. 

Syntax 

click at point 

click at point with ktyl 

click at point wiLh i'lyl. kcy2 

click at point wiLh keyl, key2, key3 

Point is a description of a point on the screen: two integers separated 
by a comma, representing the horizontal and vertical distance froa^ 
the top-left corner of the screen. » 

Keyh key2t and key3 can be any of the following key names: 
shiftKey, optionKey, Or comraandKey. 

Examples 

click at 50, 60 

click at the clickLoc with optionKey 



Chapter 3: Scripts That Make Dt'ci^iion^i 



DoMenu The doMenu command lets you execute any of HyperCard's menu 
commands from within a script. 

Syntax 

doMenu mtmnlti'm 

Menultetn can be the name of a menu command or the name of a 
desk accessory in the Apple menu. Include three typed periods if 
diat's how a command is shown in che menu; for instance, "card 
info. . .". You must type the diree periods; donr use the ellipsis 
character (Option-semicolon). 

Examples 

doMenu "New Card" 
doMenu "Print Stack,,," 

Find ^j^he tind command searches for a text string in all the card and 

background fields (visible or not) of the current stack. You can limit 
the search to a specific background field by specifying a field. 

Syntax 

find tfxX [in backgroundField ] 

Tcxtc^n be any text string. BackgtvtmdField'x^ an expression that 
identifies a background field. 

When HyperCard finds a word beginning with text-, it stops 
searching and places a rectangle around the word. 

Examples 

find "Moz" 

find "Mozart" in background field "Artist" 
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i'hc if keyword begins an if structure. An if structure rests a 
coiidirioii, tli£fn L-xccurcs one or more scateinencs if the condition is 
true. If the condition is Kdse, statements following the opcional 
else keyword arc executed. 

Syntax 

if conditiort then statcmmt 

it condition then statement else ^tafement 

if condition then 

start'incfits 
elsE* 

statm/ents 

end if ^ 

if condition then 
stattments 

end if 

Condition is an expression that evaluates to either true or false. 
Statement is a single HyperTalk statemenr. Statements can be one or 
more statements. 

Example 

if l^esponse = ''Cof red " i.lien 
answer "That's correct!" 

else 

answer "Sorry, try again," 
end if 
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DoMenu The doMenu command lets you execute any of HyperCard's menu 
commands from within a script. 

Syntax 

doMenu ntemifiem 

Mentthen} can be rhc name of a menu command or the name of a 
desk accessory in chc Apple menu. Include three typed periods if 
that's how a command is shown in chc menui for instance, "Cdrd 
info, . You must type the three periods; dont use the ellipsis 
character (Option-semicolon). 

Examples 

doMenu "New Card" 
doMenu "Print St^ck..." 

I'ind rhf Lirid command searches for a text string in all the card ajid 

background fields (visible or not) of the current stack. You can limit 
the search to a specific background field by specifying a field. 

Syntax 

find text [in hackgroundFieid ] 

Ttatcan be any text string, Back^widField\s an expression that 
idcncifies a background field. 

When HyperCard finds a word beginning with text, i: stops 
searching and places a rectangle arotind the word. 

Examples 

find "WiZ" 

find "Mozart" in background field "Artist" 
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The if keyword begins an if smiccure. An if structure tests a 
condition, then executes one or more stLiceniencs if rhe condition \s 
true. \t die condition is false, .staccmenc.s tollowint; the upiioiial 
else keyword are executed. 

Syntax 

if condition then starement 

if condition then statement else stdtement 

it condition then 

stiih-)Hin(.\ 
else 

smternans 




if condition then 

statements 
end if 

Condition is an expression that evaluates to either true or false. 
StatcTnmtis a single HypeflaJk statement. Statements c^n be one or 
more statements. 

Example 

IE Hoaponsc? = "Cof roct " i.hi^n 

answer "That's correct!" 
else 

answer "Sorry, try again." 
end if 
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Lock screen and The lock screen command prevcnrs HyperCard from Updating 
Unl(X'k screen the screen imril HypcrCnrd fncuLintcrs an iiniock screen 
cnmmand or nil handlers have finished executing. 

Synrax 

lock screen 
unlock screen 

unlock screen with visualEffen 

^'/V^^^/£'^^'ris aiiy of the fonns of die visual command. 
Examples 

lock screen 

unlock screen with visual effect zoom out slowly 
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RcpCilt A repeat Statement identifies chc first line a cepeat structure. 
Syntax 

repeat [forever j 

This loop repeats forever, or until an exit statement is 
encountered. 

repeat [for] numher [timesi 

yVwwifr Specifies how many rimes the loop executes. 

repeat unti I amfJiiimt 
repeat while cottdicion 

Condition is an expression chat evaluates to true or false. The _ 
repeat until loop repeats as long as is false. " 

The repeat while loop repeats as long as condition is true. 

repeat with variahk = start to finish 
repeat with varinbU = sturf down to finhh 

Vanable is a variable name, and start ^nd finish integers. At the 
beginning of the loop, mr/^z^^il? equals the value of start. With each 
pass through die loop, the value of variable mcr^^ by 1. (In the 
down Co form, the value of t'/zn^^^ decreases by I with each pass 
through the loop.) Execution ends when the value of variable equals 
the value finish. 

Example 

repeat for 100 times ^ 

add 1 CO Message Box 
end repeat 
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I'liL" set. command allows ytjii to chanj^c VLiiious HyperCard 
properties from within a script. 

Syntax 

set {t.hG\ property [of. ohject] 'lg expression 

l^operry sT^ds for a changeable characteristic of the HyperCard 
environment or of an object. 

Object is an identifier (or an object, such as its number, ID, or 
name. 

What expression is depends on the property. Some properties, snch 
as hilite, have die values true or false. Others, such as 
userLevel, have numeric values. Stil! Others— such as the name 
property of a button— have as dieir value a string of characters. 

Examples 

set the user Level t:o 5 

set the hilite of card button 1 to true 
set the name of card field 1 to "Horse" 
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WiliC The wait command causes HyperCard CO pause for a specified 
period of time, or until a specified condition is true. 

Syntax 

wait [for] number 
wait [for] number seconds 
wait until coTidition 
wait while condition 

Number s^^c\?it^ how long you want HyperCard to pause. If yoti 
want seconds, you must add second, seconds, or the abbreviation 
sec or sees; otherwise, HyperCard uses ticks, which have a value 
of !/&o second. No other meastiremenrs [such as minutes) can be 
used. 

G?'^;//to7i is an expression that evaluates to true or false. The 
wait until form ^d^w^c^ unvA condition \s true. The wait while 
form pauses unni condition is false. 

Examples 

wait 2 seconds 

wait 30 — waits 30 ticks (or one-half second) 
wait until the mouse is down 
wait while the mouse is up 
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Handling Messages 



Chapter 4 



A 



s you know, a message handler is a group of HyperTalk 
sraremcnc-^ beginning with an on statement, such as on majseup 
and ending with an end statement. Alt the scripts you Ve written so 
far contain t>nly one message handler, but scripts oft:en contain 
more dian one handler. 

In this chapter you'll write new handlers and explore the way 
messages travel between objects. You will add anodier feature to your 
Collection stack — a button that plays a sound when you click it. 

If you took a break at the end of Chapter 3, start up HyperCard 
and go to your Collection stack before you go on. 



y3 



How messages travel 




HyperCard can send system messages ro a burton, a Held, or the 
current card. For example, it you click a bucron, HyperCard sends a 
mouseOp message CO the button. If you click a locked field, ^ 
HyperCard sends mouseUp to che field. If you click anywhere else 
on die cardj HyperCard sends mouseup directly to die card. 

A message can travel from one HyperCard objecr to anorher— until 
it is handled. For example, when someone clicks li bution, a 
mouseUp message is sent to die button. If that buttons script doesnt 
have a handler for mouseup, the message is passed to the currenr 
card. If the current card's script doesn't have a mouseUp handler, the 
message is piissed to the background. As long as the message does 
not encounter a h^mdler> it continues traveling— to the stack, then 
to die Home stack, and finally to HyperCard itself. 

This sequence is called the message-passing order; it's illustrated in 
Figure 4-1. J 



9^ 
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Citrreni ard 

j> 



Current background 




Hyper(jrd 



Figure 4-1 The message-parsing order 
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You can place handlers at different levels. Where you place a handler 
has an efFect on \ts availability. For example, in Chapter 2, when you 
wrote the handler to label all the cards of the Collection stack, you 
placed it in the background script; that placement meaiit diat the 
handler was available for every card sharing that background. If you 
had placed the handler in die script for one of the cards, it would 
have been available only ro that card; no other cards wotild have 
been labeled. 

In this section you'll see how messages move around in HyperCard. 
Firsr you'll make a button and write a message handler for the 
buttons script. Later youHl move die hajidler to different levels in 
the message-passing order and observe die dift'erence in the 
handler's action, ^ 

Creating a ScJUncI bulUin Youll create a button that plays a sound when you click it. Follow 

these steps: 

1. Press " -B to work in the bacl^oiind. 

2. Choose New Button from the Objects menu. 

Drag the button to any available space in the background. 

3. Name the button Sound 

4. If you want to, choose a font and colors for the button, 

5. Click Script and type the following message handler: 

on mouseup ^ 

play "boinq" 
end niouseUp 

The play command lets you play sounds from within scripts. 
Boinq is die Jiumc ot the sound diat plays. 
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■> Altematii'e for hearing-impaired peopU". If you coju lit^ar well, 
type [his line in place of or in addition to the play statements to 
sec the effect of the handler: 

flash 3 

This command causes the entire screen Image to flash rapidly 
three times when the button is clicked. (The white parts of the 
card switch to black and the black parts to white; then diey 
change back again.) ❖ 

6, Click OIC 

7. Click the Sound button with the Browse tool. 

You hear the "boing' sound (or see the screen image flash). 

■fr If something else happened: Check the script's spelling and make 
sine you have included quotation marks in the right places. If 
the script is corrects malce sure you have the Sound Volume in 
the Control Panel turned up far enough, *> 

When you click die Sound burton, a mouseup message is sent to 
the butron. This causes the mouseup handler to execute, and the 
boing plays (or the screen flashes). 

Moving the handler Wliere you place a handler in HyperCard affects its acnon. A 
to the card level handler at the "top" level — chat is, in a button scripr or a field 

script — can respond only to a message received by chat btitton or 
field- The same handler ftirther "down" in the message- passing 
order — that Is, at the card, bacltground, or stack level — can respond 
to a message sent by any objects higher up, unless tho^ie objects 
intercept die message widi their ov^n handlers. (See Figure 4-1 
earlier in diis chapter.) 

What the message-passing order means to you is that you can 
control whether your handlers act very locally — only for a particular 
button, for example — or more globally, for an entire card, 
background, or stack. 



Ch;]p[ur4: H;inUling Messajies 



97 



In ^<^cnon you'll move die mouaeUp li;iiKllc-r of the Sound 
hurron ro a differenr level in the nhject hierarchy to experience the 
change in its response. 

First notice that the handler works only if you click the Sound 
burton. If you click anywhere else on rhe card, you won t hear 
anything. 

The next step is to move the handler to the script for one particular 
aird. You'll cut the mouaeUp handler from the Sound buttons script 
and paste it into the script for the Index card that you creared in 
Chapter 3, Follow these steps: 

1. Go to the Index card. 

2. Open the script for the Sound button. ^ 

3. Selea the mouseup handler. 

Drag the mouse across the entire handler to select it. 

4. Press ' -X to cut the handler and place it on the Clipboard. 

The script editor shotdd now have nothing in it. If you still see 
the handler diere, try steps 2-A again. Every object has a script, 
even if there's nothing in it. Scripts widi nothing in them are 
called efJipty scripts. 

5. Click OiC 

Now you'll open the script for the Index card, 

6. Choose Card Info from the Objects menu. ^ 
The Card Info dialog box appeal's. 

7. Click Script. 

The script for the Index card appears. 
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8. Press ' -V to paste the handler into the script for the 
Index card. 

The mouseup handler appears in the script for the Index card. 

9. Click OK. 

Tiying oul ihc ami .script 

Now test the effects of moving the handler to the card level. 

L Click the Sound bunon with the Browse tool. 

The "boing" plays (or the screen flashes) just as ir did before. 
The mouseup message passes through the empty burton script 
and goes on to the card script. 

2. Click anywhere else on the Index card (except on a button or 
field). 

The "boing" plays (or the screen flashes) because whenever you 
click the card, mouseup goes direcdy to the card, which now 
contains the handler for mouseUp in its script. 

3. Click the Next button. 

You go to the next card as usual — ^without hearing a sound. The 
mouseup message goes to the Next button, where the message is 
handled by the mouseUp handler in the burtons script. 

Now that you are on a card other than the Index card, notice what 
happens when you click the card. 

4. Click anywhere on the card (except on a button or field). 

Nothing happens because there is no mouseup handler in this 
card's script. 
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M(5Vinj5 the hiliullur iO Now you'll lake iUc W.Widhi uui uf tliucid script and move it ro 
the background level the bad^round script: 

1 . Go to the Index card. 

2. Choose Card Info troni the Objects menu. 
The Card Info dialog box appears. 

3. Click Script to see the script editor 
The script for die Index card appears. 

Keyboard shortatt: You can press i^-Option-C to see the script 
editor of the current card widiour having to go through the 
Info box. * 

4. Drag the mouse across the entire handler to select it. ^ 
5* Press '""-X to cut the script and place it on the Clipboard. 

The card script should now be empty. 

6. Click OK to close the Index card's script. 

7. Choose Bkgnd Info from the Objects menu. 
The Background Info dialog box appears. 

8. Click Script. 

The script for the current background appears. 

9. Press -V to paste the handler into the backgroimd script. 

10. Click OK to close the background scripL ^ 

11. Test the effects. 

Using the Browse tool, click the Sound button, dien click 
elsewhere on the card, just as before. You should hear the 
"being ' (or see the screen flash) in every case. The mouseup 
message goes through the empty Sound button script and 
empty card script to the bacl^round script, which now conrains 
die handler. 
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Now move to any other card in chc stack and click any Eirea 
except a button or field. You should still hear the "boing" (or 
see the screen flash). The handler is now available to any card 
sharing the background. 

If you moved che handler to the stack level, the same thing would 
happen because the Collection stack has only one background; 
however, if a stack has more than one background, only a handier ar 
the stack level or above would be available to all cards of all 
backgrounds. 



Handlers calling 
handlers 



All the handlers youVe written so far respond to system messages 
sent by HyperCard (such as mouseUp and openCard). HyperCard 
sends system messages in response to events such as mouse clicks, 
keyboard actions, and the creation or deletion of objects. (The 
Appendb: contains a list of all HyperCard system messages.) But 
there are other ways for handlers to "get the message." 

Each time HyperCard executes a statement within a handler, it 
sends diat statement as a message. A message sent from one handler 
can cause another handler to execute. It's as though the handlers are 
Talking ro each other, with one handler telling the other to begin 
executing. 

In this seaion you'll write a handler that "calls" another handler 
First you'll write a handler that sends a message, then youll write a 
handler that responds to that mess^e. 
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Vtriting the YoLi will write a script for the Sound button so that a message 
''culling" hlincller named piaysound is sent whenever someone clicks the burton. 

Later you'll change the mouseUp handler in the background script 
so diat it responds to the piaysound message. Follow these steps: 

L Open the script for the Sound button. 

The script should be empty. 

2. Type the following handler 

■ 

on mouseup 

playSound 
end mouijeUp 

In English, the script says, "When someone clicks this button, 
send a message named piaySound. That's all. ' 

The message name piaySaund is arbitrary. You cotild use any 
other word (except a HyperTalk keyword); this name seems 
appropriate because it describes the action of die handler, 

<r Alternative for heaiirig-hnpaired people: If you are using the 
flash 3 alternative instead of the notes, you could use a 
different name, such as raazieDasEle {but don t use f lash). B 
sure, however, that you use your alternadve name in the steps 
thai follow. 

3. Click OK, 

You will need to write a handler that handles the piaySound 
message. But for now, see how the script works so far. 
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4. Click the Soiind button with the Browse tool. 

You see .\ "CaiVt utidensntnd" dialog box. HyperCard cin t 
understand the piaysound message because it can't find a 
piaysound handler anywhere, hi other words, there s no handler 
that begins with the staremcnt on piaysouna and ends with die 
stacenienc end playSound. 



Can't undtr; tond "plaiiSDund". 




Figure 4-2 ' CLin'i undLTMUmcl" dialog box 



5- Click Cancel to close the "Can't understand*' dialog box. 

Writing tlie Now you'll create a handler that responds to the piaySound 
^'called ' hLindler message that's sent when someone clicks the Sound button. You 

could write a handler from scratch, but in this case you'll simply 
change the mouseup handler in die background script to a 
playSound handler. 

L Choose Bkgnd Info from the Objects menu, 

2. Click the Script button. 

The script for die background appears. 

❖ Keyboard shortcut: You can press " -Option-B to see the script 
tor the current baclcground. •> 

3. Select the word mouseUp in the first line of the handler. 

Drag across the word as you would when selecting any texr, or 
just double-click die word. 

A. Type playSound 

playSound replaces mouseup. 
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5. Select cnouseup in the last line of the handler and replace it by 
typing playSaund 

The completed handler looks like rhis: 

on playSound 

play "boing" 
end playSound 

You have changed the handler from a mouseup handler 
to a piaySoLind handler. It now responds to the message 
playSound instead of the message mouseup. 

6. Click OIC 

You have creared a handler that sends a message named piaysound, 
as well as a handler that responds to playSound. Now see how the | 
two handlers work Together. 

7. Click the Sound button with the Browse too!. 

When the Sound burton receives mouseUp, its handler in turn 
sends the message piaySound. That message goes through rhe 
message- passing order undl it's intercepted by the playSound 
handler in the background script. The piaysound handler 
executes, and you hear the "boing." Figure 4-3 shows the path 
taken by the playSound message. 

Clicking anywhere else on the card won't cause die notes to play, 
because the background handler isht a mouseUp handler any more. 

In this section yuuVe essentially defined a new command named 
playSound. The playSound command plays a "boing" sound. ' 
That's really all there is to defining your own commands. Think of 
what you want a command to do. think of a name for it, and write 
a handler that uses the name after on and end, with the 
appropriate HyperTalk statements in between. 
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Figure 4-3 ^ie^isage irjvLHing to a handler in the background .scripE 
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■:■ By the imy: It's generally best to avoid using the name of an 
existing HyperTalk command or function as the name of a 
cammand you create. See the HyperCard lies Saipt Lanfftdge 
Guide for details on iianii[ig commands, ^ 

Intercepting a message When HyperCard sends a statement within a handler as a message, 

the message goes first to the object that contains the handler being 
executed- (For exaniple, when the Sound button sends a piaySound 
message, the message first goes to the button itself.) If the objea's 
script doesn t have a handler for the messagei the message next 
travels to the current card. If the script for the current card doesnt 
have an appropriate bai^dler. the mess^e continues through the 
message-passing order, as shown earlier in Figure 4-1 . ^ 

Once a message is handled, ir does not continue passing through 
the message-passing order. Therefore it's possible for an objea at 
the ''top" of the message-passing order to intercept a message before 
the message can travel to objects at the '"bottom." 

In this section, you'll write a piaySound handler for the script of the 
Index card. This card-level handler will make the Sound button 
play a difterent sound when you're on the Index card. 

Follow these steps to write the script: 

1. Go to the Index card. 

2. Choose Card Info from the Objects menu, then dick the 
Script button to see the card's script. ^ 

Or press -Option-C. 

3. Type the following handler: 

on playSound 

play "harpsichord" "c e g" 
end playSound 

This handler plays three notes using the harpsichord sound. 
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4. Click OK. 

5. Click the Sound button with the Browse tool. 

The piaySound handler in the card iicripc execuces, and you hear 
rhe three notes, 

6. Go lo any other card in the stack and cUck the Sound burton. 

The playSound handler in rhe background script execures, and 
you hear rhe "boing." 

How the handlers work 

When you dick rhe Sound button, the burtons mouseup handler 
sends a piaySound message- Because there is no piaySound 
handler in the burtons script, the message passes to the script 
for rhe current card. 

When the hidex aird is rhe current cardi the playSound handler in 
the card script handles the piaysound message. Hie card script 
intercepts the message before ir can pass to die background script. 
Figure 4-4, on rhe nexr page, shows rhe parh taken by the 
piaySoand message when rhe Index card is the currenr card. 

Wlien the Index card is not the current card (that is, when there is 
no playSound handler in the scripr for rhe current card) the 
playSound message continues passing from object to object in the 
message-passing order until ir gers ro the piaysound handler in the 
background script, as shown in Figure 4-3. 

^ By the way: You can allow a message to continue passing 
through the message-passing order after ir has been handled 
by using the pass keyword. (For more information abour 
pass, see the HyperTalk Help stack or the HyperCard IlGS 
Script Larifftage Guide.) •> 
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Figure 44 Message licin^i ]niercepl^.'d hy a liantller in [lie e:irLl 
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By writing ii difToa-nr pi.T/^nund hjindlcrr for rhc script ofcach card, 
you can play a dittcrcnt sound on each card in your Collection 
stack. (The reference section at die end of this chapter explains how 
to use the play command.) 



Calling handlers from 
the Message box 



Whenever you type something into the Message box and press 
Enter, the contents of the Message box are sent as a message to the 
currem card. 

In this section you'll use the Message box to call the piaySound 
handler. Follow these steps: 

1 . Open the Message box. 

2. Type playSound and press Return. 

A playSound message is sent from the Message box to the 
current card. If youVe still on the Index card, the messi^e is 
handled by the piaysound handler in the card script and you 
hear the three harpsichord notes. If you're on another card> the 
playSound message travels to the background script, and you 
hear "boing," 

You can tise the Message box this way when you want to test 
how a particuIiU' handler worlds. All you do is type the name of 
the handler and press Return. 

You can send a message direcdy to a specific object, bypassing the 
message-passing order, by using the send keyword. The send 
keyword works in the Message box as well a;^ in handlers. Now 
yoti'll send a mouseup message from the Message box directly co a 
button. 
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3. Type send mouseiip to bg button "next" and press Retum, 

A mouseup mejisage goes CO the Nexc buccon. Tlie mouseup 
handler in die burtons script executes, and you go to die next 
card in the stack, just as if you had clicked the button. 

The send keyword lets you send messages against the normal flow 
of the message-passing order — for example, from a stack script ro a 
burton or from one button to another button. 

4. Close the Message box. 



Handler S tlS In some ways getting things done in HyperTalk is no different from 
builclillS blocks ^^^"-'"S things done in everyday life. When you wanr to perform a ^ 
^ laige, cojiiplex procedure, you can divide the procedure into smaller, 

more easily manageable parts. These smaller parts of a complex 
procedure are sonieumes called mbproceelum. 

For example, suppose you want to make spaghetti. You might divide 
the main procedure, ''malce spaghetn," into three subproccdures: 
"cook pa-ra," ''cook sauce," i.md "add sauce to pasta," If you could 
describe the procedure of making spaghetti as a HyperTalk script, it 
would look something like diis: 

on matteSpaghett i 
cookPasta 
cookSauce 
d ddSa u oeU'o Pa jj t j 

end makeSpaghetti ^ 

The handler for the main procedure {makeSpaghett i) calls 
handlers for three subproccdures (cookPasta, cookSauce, and 
adds auceToPa st a ) . 

HyperCard handlers can be used as subproccdures in much the same 
way. Understanding how handlers can call other handlers will be a 
big help you as you begin ro write longer, more complex scripts. 
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what you've done In chis chapter you have demonstrated the three ways that 
in this chsptCr HyperCard cin send messages: 

■ System messages (such as mouseup) are sent in response to some 
event, such as a mouse or keyboard action. 

■ Statements within handlers (such as piaySound) are sent when the 
statements are executed. 

■ The contents of the Message box are sent when you type something 
in and press Return. 

You Ve learned how a message handler can "call*' other handlers* 
how messages can travel from one object to another, and how 
handlers can be used as subprocedures. 

Hcre*s a list of the HyperTalk words you have learned; 



Commands 

play 



Caiises sounds lo play. 



Keywords 

send 



Sends messages direcdy co objects. 



Miscellaneous 

ha cpsi chord 
boing 



Names of sounds used with rhe play 
com mand- 



ChapiLT 4: Hundling Messages 



lU 



This section describes che syntax of the play command and the 
send keyword. 



The play command lets you play sounds from within a script. 
Syntax 

play \mmid] f tempo] \ mies] 
play stop 

Soundls harpsichord or boing — ^which are included with 
HyperCard — or the name of a digitized sound from some 
outside source. 

Tempo is the word tempo followed by a positive integer that seis th|^ 
speed of play. The value 100 is a medium speed; higher numbers 
play faster. If you dohf specify a tempo> tempo 100 is assumed. 

Notes up the melody sequence. Notes are represented by the 
letters A dirough G Rests (or pauses) are represented by the letter K 

If you don t specify any notes, HyperCard plays a single note in the 
sound you specify. You should include quotation marks around the 
sound and the notes. 

You can include further modifiers after the note name, such as an 
accidental (a sharp or flat), an octave specification, and a duration 
code. Here's the syntax for a note: 

nofeName [accidental ] | octave] | duration] 

Accidental \s ax^xQT # for sharp or b for flat. ^ 

Octave is a whole number that specifies the pitch ninge. For 
example, q#4 would be the G'-^harp note in the middle range> or 
what musicians call the middle-C octave. Higher numbers give 
higher ranges, and vice versa. If you don t specify a number, 
HyperCard uses 4. 
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Drtrntiofi is a letter code indiaiting how long to hold die note 
before the next nore sounds. Here are the codes for note dtiriition: 

w whole note (four coiinrs) 
h half (two counts) 
q quarter (one count) 
e eighth (one-haif count) 
s 16th (one-fourth count) 
t 32nd (one-eighth count) 
X 64th {one-sixteenth cotmt) 

If you don t specify a duration code, HyperCard assumes a 
quarter note. 

A period (.) after the duration code indicates a dotted note, which 
means a note with a duration value of half again as much; that is, w. 
would indicate six counts (four plus half of four). A numeral 3 after 
the duration code indicates a triplet. 

The codes for octave and duration carry over to subsequent notes 
unless you change them; this feature saves you from having to type 
numbers and letters over aitd over 

Here are some examples of notes with modifiers: 
Note 

specification Meaning 

d#5w D-sharp above high C held for four counts 

Bb4q B-flat above middle C heldfor one count 

e5h. E above high C held for threecounts (because of 

the period after the duration code h) 

Example 

play "harpsichord" tempo 300 "cq d#q gq c5w" 
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Di-alijifi widi long lines 

You uui pill ;i long sct|in:ii£:t.- of [lotcs inti* d script; howt:ver, the 
script editor docsn c wrap lines or let you scroll to see lines that 
extend beyond the window. You caii press Retinn or Opdon-Return 
to wrap a long line temporarily while you type the notes; however^ if 
you use this method you miistdclcic the Returns to ''unwrap" the 
lines when you'te finished. If you don t. the script won t work 
properly HyperCard doesn t understand a line break of any sort 
inside quotation marks. 

Anndicr alterniuivc- is to wrap a long line permanenily by inserting a 
closing quotation mark and the double ampersand followed by 
an Option-Return (-.): ^ 

play "harpsichord" "c3 cie£gabc4def" i 
"g a b c5 d e f q a b c6" 

Notice that you must ;dso begin the wrapped line with a 
quotadon mark. 



Send The send keyword directs a message to any object in the current 
stack or to ajiother stack, but not to a specific object in anodier 
stack- It sends a message direcdy Co the specified object, bypassing 
any other objects in die ttsual message-passing hierarchy. 

Syntax 

s<?nd " mesiiigeNimie " | to ohjfct] — 

The quotation marks around the name of the message aren t needec 
if the message is a single word, like mouseup, 

Ohject is an identifier for any object, such as its number, ID, or 
name. If you ttse the name, you must enclose it in quotation niarlis 

Example 

st?nd moiisoU|j lo baclttjruurid button "Home" 
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More Scripting Ideas 



chapter 5 



s you built your Collection stact:, you learned some of the 
basic mcchodsS you uin use for HyperTalk scripting. In this chapter 
you'll learn otlier ways ot using scripts in stacks. 

This chapter explains how to modify the Collection stack for 
other purposes. It also describes some other simple stacks you can 
build — including a presentation stack, animation stacks, and a 
stack just for dm — and explains the basic steps involved In building 
and scripting these stacks. You can try building the stacks if you 
wish, or you can tise them as a source of ideas for creating stacks on 
your own. 



in 



Customizing your You can easily modify the Collection stack to catalog things otlier 
Collection St'lCk ^^^^ records. For instance, you could modify the stack along chc 

lines shown in Figure 5-1- 




Figiire 5-1 AnotlJLT v:m:iiion on (he records sriiik 

To modify the Collection stack for some other purpose, follow diese 
basic steps: 

1 . Save a copy of the Collection stack by choosing Save a Copy 
from the File menu. 

2. Change the names of the Artist and Tide fields to indicate the 
new contents of the fields. 

3. Change the scripts of the Sort and Index buttons, replacing all 
references to the Artist and Tide fields with the new field ^ 
names. 

You might also want to delete the Soimd button and create more 
appropriate graphics. 
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Presentation stacks Yoli can use HyperCard to combine text, graphics, anirriLiciun, and 

sound into a dazzling presentation. This section shows you how lo 
create a ha_sic presentation stack. You can 1111 in the contents of the 
preseniauon (and liie dazzle) yourself. 

There are many ways you can organize a presentation. One way is 
to tell a scory from beginning to end by having users go forward or 
backward from card to card. In most stacks, though, users have 
opportunities ro branch to different parts of [he stack, depending 
on what interests them, (See HyperCard Stack Design Guidelines, 
publisiied by Addison-Wesley, for a discussion of different ways to 
structure a stack and how to make staclts easy ro navigate.) 

The stack described in this section uses a simple tree srrucrure diat 
I users can easily navigate. The first card of the stack Uses the topics of 

the presentation. A user chooses a topic of interest by clicking a 
button. Once a topic has been chosen> the user can navigate 
through a series of cards about that topic. The user can also return 
to the main topics card at any time. Figure 5-2 illustrates the 
structure of the stack. 
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Creatinj^ :i main Here is an example of a main topics card. 

topics card 



Clidabpic 





Birds 




Figure 5-3 Main topics card wiih ;irr the user can click ^ 

The ciird shows several pictures, each corresponding :o a topic che 
user can pick, Each piciure is covered widi a transparent button chat 
takes the user to a card about the chosen ropic. For example, the 
button covering die flower picture has this script: 

on mouseup 

visual effect dissolve 

go to card "Wildf lowers" 
end mouseUp 

In this case, wiidfiowers is die name of the first card in a series of 
cards about wiidfiowers. 



Creating cards 
about a topic 



Once you have decided what the topics of your presentation are, 
you can create a scries of cards about each topic. Figure 5-4 shows 
an example of a card about a topic. 

You can create topic cards by following these basic steps: 

I . If you want the background of the topic cards to be different 
from the background of the main topics card, create a second 
background for your stack. 
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You do this by choosing New Background from the 
Objects menu. 




1 



fliDumiidBol ^ioBofwiHTfivBrBQrerBtivBtbHanLBrBg " 
County AiTfingUiBmoEttLQiwmnaretha-EalUornB 
th03lgLupiMjndtnPQmthrurii,nrrfthBCQliIoriuQWil(jRDE8. " ~" 
HQEt or thoEB fbwerE blonmfrom late Harch 
through Hog. 




Figure 5-4 A Eupic card 



2. Create buttons for the background. 

You'll probably want a Next button, a Previous button, and a 
button that returns the user to the main topics card. 

The Topics button in Figure 5-4 rakes the user back to the main 
topics card; it has the following script. 

on mouse Up 

visual effect dissolve 

go to card "Topics" 
end mouseup 

3- Create bacl^round Gelds. 

You will probably want a field for the heading, as well as a field 
for the text on each card. 

4. Add cards to your stacL 

Write the text and create the graphics for your presentation. 
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Animation You Gin use HyperTalk commands ro create Liiiimation effaces. 

Animation combined with visual efFecrs and soimd can turn a 
presentation, a demonstration, or a training stack into an exciting 
, , audiovisual experience. This section explains two ways ro create 

animation effects with HyperTalk commands, 

Aninillting U S^ri^S of C^rds You can ;inimacc a series of cards by painting sllghdy different images 

on successive cards, then showing the cards rapidly — creating the 
appearance of movement. Figure 5-5 shows an example of a multiple 
card animation sequence. 

You can practice creating an animation sequence by following 
these steps: 

1 . Create a new stack, ^ 
Name the stack Animation or any other name you'd like. 

2. Add a few cards to the stack, and create grapliics for each card. 

You can paint your own graphics or copy them from the Art 
Ideas stack. 

Each card should look slightly different from the card before 
it. To create each card, copy the image from the previous card, 
dien change the image by moving graphics or adding graphics 
to the card. 

3. Create a button that makes HyperCard flip through the cards. 

In Figure 5-5, the button is named Drive the Train. Here's the ^ 
script for the burton: 

on mouseUp 

go to first card 

show A cards 
end moiJseUp 




Figure 5-5 l:>:Liiiiplu of iiiulliplc lui'lI jnitiialkiii 
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Animatino with Paint tools You can create animation effects by using HyperCard's paint 

tools within scripts. In this section youH learn the basics of 
paint animation» and you'll write a script char creates computer- 
generated art. 

You'll write a script that paints rectangles and lines of random sizes, 
shapes, and colors. Each "painting" is unique, but Figure 5-6 shows 
an example of what one might look like. 




Figure 5-6 A Hyi>erTalk-^enenied "painting' 



To paint each shape, your script will: 

■ choose the appropriate tool (either the Rectangle tool or the 
Bmsh tool) 

■ choose a random color or pattern (When che Brush tool is 
selected, it will iilso choose a brush shape.) 

m drag from a random point on the screen to another random 
point. 

Follow these steps to make the stack; 
1- Create a new stack. 

Name the stack Piiinting or any other name you'd likt:. 
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2. Open the stack scripL 

Choose Stack Info From the Objects menu and click Script. Or 
press ' ''-Option-S. 

3. Type the following script: 

on fyiDusellp 

set the dragSpeed to 200 

set the filled to true 

repeat until the mouse is down 

choose rectangle tool 

set the pattern to randoni(32) 

drag frnm r.andom (320) , random (200) do 

randomt320) , random(200j with optionKey 

choose brush tool 

set the brush to randDm(32) 

set the pattern to randDin(32) 

drag from randomi320, random (200) to — i 

random (320), random (200) 
end repeat 
choose browse tool 
end mouseup 

4. Try out the script by clicking anywhere on the stack with the 
Browse tool. 

Watch the screen as lines and rectangles of different colors appear. 

5. To stop the animation, chck the mouse again. 

U you'd like to start a new painting on a blank card> choose New 
Card from the Edit menu. 

ifsomer/mtg else happened: Check your script and try again. You 
cannot open the script editor while a Paint tool is chosen. To 
open the script editor you must have the Browse tool, Button 
tool, or Field cool chosen. 
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How [he script works 

Wlien you dick anywhere on rhe srack, a mouseUp message travels 
to the stack and the mouseup handJer executes. 

The sraccment set the dragSpeed to 200 determines how fast 
drags wiil occur. The higher the dragspeed* the Foster the drag. If 
you don't specify a speed* dra^ occur instantly. 

The next statement sets the filled propcny to true, which means 
that rectangles and other polygons will be painted as soHd shapes^ 
instead of oudines. 

Next comes a repeat structure that keeps looping until you click the 
mouse (that is, until the mouse is down). Each time through the 
loop, the script paints one rectangle and one line. ^ 

First rhe script chooses the Rectangle cool, as though you had 
chosen it from the Tools menu. 

The next statement set the pattern to random(32) sets the 
pattern property to a random number between 1 and 32. Each 
position in the Patterns menti has a corresponding number, as 
shown in Figure 5-7. 




Figure 5-7 Vjlues for [he paiiern propetry 
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To choose a pattern randomly, the script uses the randoin function, 
which hiis this syntax: 

random ( number) 

The random fimctinn returns an integer from 1 to number. Thus 
evaluate the expression randomfjZ) iis a random integer from 1 
to 32. 

The next statement 

drag from random (320) , random £200) to random (320) , random (200) with optionKey 

uses the drag command to drag from a random point on the 
screen to another random point while holding down the Option 
iiey. (Holding down the Option key paints rectangles as solid 
shapes without showing black oudines.) The syntax of the drag 
command is: 

drag from startingPoint to endingPoint [with key] 

StamngPoint .md endhigPoint points on the screen. Each point is 
specified by two numbers separated by a comma. The first number 
specifies the distance (in pixels) from the left edge of the screen, and 
the second number specifies the distance from the top of the screen. 

The top-left point on the screen has the coordinates 0,0; the 
bottom-right point has the coordinates 320,200. Therefore, the 
expression random(320) , rdndomi200) specifies any random poinr 
on the screen. 

After the rectangle has been drawn, the script chooses the Brush 
tool and a riindom brush shape. The brush property determines 
which brush shape is used; it can have a value from 1 lo 52^ as 
shown on the next page in Figure 5-8. 
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Figure 5-8 Values for ihe brush property 

The scQjJid t!i\ig a>iiiiiiaiid drags the Brush tool to piiinr a 
-Straight hnc. 

Wlien you dick the moose, die script stops looping dirough the 
repeat structure. 

Finally the script chooses the Browse tool again. 



A Stack for fun Here s another stack that produces random evenrs with interesdng 

results. Irs easy to build and fijn ro play wtch. It randomly generates 
newspaper headlines from lists of words diat you supply. 

1. Create a new stack. 

Name the stack Headlines or whatever you like. 

Next you 11 add some fields and burtons to die first (and only) cart^ 
in the stack. " 

2. Create three fields named Man, Bites> and Dog. 
Choose "scrolling" for the field's style. 

3. Type some words or phrases into die fields. 

In die field named Man, type the names of some friends. In the 
field named Bites, type some verbs. In the field named Dog, rype 
some nuuii-s. IVess Retuni after each word or phrxsc to put it on 
a sqiararc line. 
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For now you can jusr type two or three lines into each field, h will 
be easy to add more words later. Figure 5-9 suggesrs sonic words 
you can type into these fields. Have fun making up your own. 



Man field 



Biles Field 



Dog field 



Ktvin 

Cbi 
Jidif 







Do 9 


li 


Thing trai Vtrwa 














ffttli 




HollkPfcadStQElPi 






Infnnl Geniui 


Bentacpd 






iewni far 







ShD«f/llid( 



Figure 5-9 S(ime it-xi for [he Man, Mc^, and Dog fickU 



4. Create a button named Show/Hide that makes the scrolling 
fields appear and disappear. 

Write the following script for the button: 



on niouseUp 



if the 


visible of 


card field 


show 


card 


field 


"Man" 


show 


card 


field 


"Bites" 


ahow 


card 


field 


"Dog" 


else 








hide 


card 


field 


"Man" 


hide 


card 


field 


"Bites" 


hide 


card 


field 


"Dog" 



end if 



end mouse Up 
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The visible property of a fidd (lerermines whether the field is 
shown or hidden. Wlien a field is shown, the visible property' 
of the field has a value of tine. When the field h hidden, the 
visible property has a value of false. 

This script tests whether the Man field is hidden. If the Man field 
is hidden, the script shows all three scrolling fields. Otherwise, if 
the Man field is shown, the script hides all three fields. 

Select the Browse tool and try out the Show/Hide button. By 
clicking the button, you should be able to make the scrolling 
fields appear and disappear. 

Now you'll create a field for the headline and a button that 
randomly generates headlines. ^ 

5- Create a field named Headline. 

Choose a large, bold font. Choose "center" for the field's text 
alignment. 

6. Create a button named Write Headline. 

Write the following script for the button. Press Oprion-Return 
to insert a ''soft" return character (-) where necessary. 

on mouseup 

put any line of card fiel6 "Man" i& -i 

any line of card field "Bites" S& -i 

any line of card field "Dog" -i 

into card field "Headline" 
end mouseup 

7- Try out the Write Headline button. 

Each time you click the button, a different headline appears. If 
something else happens, check your script and try again. 
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8. Paint some graphics on the card to make it look like the front 
page of a newspaper. 

Here is one possible design: 







Kevin Weds 
Space Alien | 







Figure 5-10 .Sample graphics for ihe Man Biies X)og stack 



How the Make Headline button worLs 

The script combines any line from the Man field, any line from die 
Bites field, and any line horn the Dog field into a single string of 
text — which is pur into the Headline field. 

Games are often based on randomly occurring events, such as the 
roll of dice. One way to create random events in HyperTalk is to 
list all of the possible outcomes in a field and then get any line 
of the field. 
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Where to Now rhat youVe an experienced scriprer, you can go on to other 
from here ^"^"^^^^ Ic^n more about HyperTalk and more ways of using 
HyperCard. Many people have written hooks on HyperCard and 
scripting that you might find helpful. The HyperCard I Ics Script 
Ijingimge G^Wd- contains complete descriptions of HyperTalk 
elements. The HyperTalk Help stack is also a good reference to 
consult while you're working. 

Look again at the stacks that come with HyperCard, especially 
Button Ideas. See what you can observe about the way their scripts 
work, and how you might modify some of die scripts to suit your 
own ways of doing things. Create a stack you can use as a repository 
for buttons with prewritten handlers and other scripts that you can 
copy and paste when you want them. Talk to other HjpcrCard 
scripters about the stacks they Ve bulk and how th^ ve built ther^ 

Most of all, enjoy the crearive environment that HyperCard 
provides. Experiment. Build your own stacks for your own 
purposes, learning more about HyperTalk as you need to. Your 
most valuable knowledge of scripung is likely to come from your 
own experience. 
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What you've clone YoLiVe learned hnw ro modify your Collection stack for difteren 

in this ch'lDtCr P^^^P^^*^^' how to create a simple presentation stack, 
' add animation cfTcccs to stacloi, and a fun way to uS' 

function. 



two ways to 

use the randnm 



Commands 

choose 

drag 

tihow cards 



Properties 

drag speed 

filled 
pattern 

visible 



Chooses a tool just as chough you chose it from 
the Tools menu by using the niouse. 

Does the same thing as dragging the mouse. 

Shows cards one after another on the screen. The 
cards to be shown (all or some number) must be 
in sequence. 



A global property diat determines how fast rhe 
drag command is executed, 

A painting propeiiy — when sec to true, shapes 
are filled as they are drawn. 

A painting propeny with a value of 1 to 32, 
corresponding to the pattern selected in the 
Patterns menu, 

A property of fields and burrons that has a value 
of true when the object is shown and false 
when it is hidden. 



Functions 



mouse 



random 



Gives die state of the mouse button: either up 
or down, 

Gives a random integer between 1 and a specified 
number. 
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Syntax siinuiiaries Here is the syiiiax of the commiuids you learned in this chapter. 

CllOOSC The choose command allows you to select a HyperCard tool from 
within a script. 

You can use the choose command ojily when the u^er level is set to 
Painting, Authoring, or Scripting. You can set and reset the 
userLevei property inside a handler with the set command, if 
you don t want to change the user level permanendy in a stack. 

Syntax 

choose tootNnmt tooJ. 
chooae tool number 

ToolName is any one of the HyperCard tools from the Tools men^ 
You mtist always use ^ooi after the name. Here ;ire the Hj-perTalk 
names for the tools that you can use: 



browse 


field 


reg [ular] poly [gon 


bi:ush 


lasso 


round rect[angle] 


bucket 


line 


select 


button 


oval 


spray 


curve 


pencil 


text 


eraser 


rect [angle] 





Numberh a positive Integer corresponding to one of the tools. 

The only tool you can t choose from within a script is the 
Polygon tool. 

Examples 



choose button tool 
choose tool 9 
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DruJJ The drag command allows you to manipulate objects aiid graphics 
on a card from within a script. It has the same fffect as dragging rhe 
mouse manually from one point to anodicr. 

Syntax 

drag from point to poini 

drag from point to point with kffy! 

drag from point to point with k^yi, key2 

drag from ptiint to point with keyl, keyl, kty3 

Pomtconsists of the horizontal and vertical coordinates of a point 
on the scrccn> separated by commas. You can find the coordinates 
ot A point by placing tht pointer there and t\'ping the mouseLoc 
Into the Mcs.sagc box, 

Key}, key2^ and can be shiftKey, optionKey, or commandKey, 
Examples 

drag from 5,5 to 80,130 

drag from 5,5 to 80,130 with commandKey 



Show cards The show cards command lets you quickly display a number of 
cards in sequence. 

Syntax 

show [all 1 cards 
show positivehueger c^r6.s 

Positii'dnteger is the number of cards you waiu to show it you don'c 
waiit to show all of them. 

Examples 

show all cards 
show 5 cardiS 
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HyperTalk Sumniaiy 



Appendix 



his appendix contains 

SynLix statements for all built-in HyperTalk commands, 
functions, and keywords 

Lists of system messages, properties, and constants 
A table ofopeiators and dieir order of precedence 
Script editor keyboard commands 
Sliorrcurs tor seeing scripts 
Synonyms and abbreviations 
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Add 25 Co line 1 ol card field "sijm" 
V 



r 

Ansver "Hov ai'& yi^u'J' vith "Fine, thanks ' 




Syntax statement Syntax scaremenrs show the most general form of a command or ^ 
nOttlliOn f^^f^^^^""^ ^^^^^ aJl elements in the correct order. The synrax 

statements in this book use the following typographic conventions: 

■ Words or phrases in this kind of type are Hypertalk language 
elements that you typ>e exacdy as shown. 

■ Square brackets [ ] enclose optional elements chat may be 
included if you need them. (Don c type the brackets.) In some 
cases optional elements change what die command does; in 
other cases they simply make the command more readable. 

■ Words in italiczx^ placeholders describing general elements, not 
specific names; you must repiace them in an actual command. 
For cx;imple, effirrNnmc sismds for any of the HyperTalk visual 
eftecc names, such as barn door, checkerboard, or zoom out.^ 

It doesn t matter whether you use uppercase or lowercase letters in 
HyperTalk, but names formed from two words are often shown in 
small letters with a capital in the middle (likeThis) to make them 
more readable. 
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ComniancLs This section lisrs the syntax of all HyperTalk commands. For more 
infnrmarion cibout ochcr HyperTalk commands, see the HyperTalk 
Help stack or the HyperCard IlGS Script Lanff.mge Guide. 

add number to [chunk of J container 

answer question 

answer question with reply 

answer question with reply! or reply2 

answer qufsiim with nply! r.r rifly2 ui reply3 

answer file text \ot type JiltType] 

arrowKey direction 

ask question (with drfnultAnswer] 

ask password question [with defaultAriswer] 

ask file text |with fileName] 

beep { number] 

choose taolName tool 
choose tool numher 



click at point 

click at point with keyl 

click at point with key!, keyl 

click at point with key] . key2, bey3 

close file fileNnme 

close printing 

controlKey keyNumher 

convert [chunk of} container to firrmt [and Jbrmat] 

create stack stackName [with background] 

delete chunk of container 
delete [stack] stackNa me 

(Jial number 

dial number with nicdem [modeniComnuinds] 
divide [chunk ot] container hy number 
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doMena menuliem I wiLhout dialog) 



drag from f>pint t:o point 

drag from point to point with keyJ 

drag from point to point with kcylf 

drag from point to point with keyi^ ^^2, 

edit script of object 

enterKey 

export paint to file filename 
find text 

find text [in back^oundfield \ 
find chars text fin backgrottndField ] 
find word [in back^oiindfield \ 

find whole fiSrt [In backgroundfield ] 
find string Xfxr [in backgroundField ] 

f unct ionKey keyNuniber 

get expression 

go [to] J/^^fjt 

go tto] background [of stack] 

go [to] fflri;/ [of background] [of j^^^r^ ] 

help 

hide button 
1 1 idt? //r'i/ 

hide card picture 
hide picture of card 
hide background picture 
hide picture of back^ound 

hide menuBar 
hide message box 
hide tool window 
hide pattern window 
hide go window 
hide card window 

I Ml| ">i I J I, I i III I T r iin I i I jilninnH' 
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lock I Lhe| iriLTfrnpIdLe 



lock screen 

multiply [chunk of] container by number 

open \fiUName with] appUcationName 

open file fileN/ime 

open printirig [with dialog] 

play sound [tempo] [notes] 
play stop 

pop card 

pop card into [chunk of] container 

pop card after [chunk ofj container 

pop card before [chunk of] container 

print fiey 

print Jili-Niiim' wjLti ttpplicutionName 

print card 

print number cards 

print card 

print all cards 

push card 

put expression 

put expression into [chunk of] container 
put expression after [chunk of] container 
put expression before [chunk of] container 

read from file fileName at xwrf for numberOfChars 
read from file fileName for numherOJChars 
read from file fileName until character 
read from file fileName until end 
read from file fileName until eof 

reset paint 

returnKey 
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saue this stack as filcName 
f^ave this sLat-k ci.s piuhNai/iv 
save IstarkI stitihNiiine a?; fii^Nnmf 
save [stackj stackName as pathName 

select button 
select 

select text of container 
select before text of container 
select after text of container 

select chunk of container 
select before chunk of container 
select after chunk of coniuintr 
select empty 

Note: cornaimr 'is a field or the Message box. 

set [the] proper^ [of object] to expression 

show button [at point] 
show field [at point] 

show card picture 
show picture of card 
show background picture 
show picture of background 

show menuBac 

show message box 

show tool window [at point] 

show pattern window [at point] 

show go window ian point] 

show card window 

show number cards 
show all cards 

sort [sortDirection] {sortStyle] by expression 
subtract number from [chunk of] container 
tabKey 
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Lype text 

type text with i^eyl 

type text with i'lyl. kiy2 

type text with ^^ey/, key2, key3 

unlock [the] printTemplate 

unlock screen 

unlock screen with ifrs7ialEffect 

Note: visttalEffect is any form of the visual comman 

visual [effect] eJfkiName [speed] [to image] 

wait [for] nurnbrr [secondsl 
wait until comlition 
wait while condition 

write text to file fileName |at start] 
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Fli actions This section lisrs rhe syntax For all of Hyper Talk's built-in Rinctions, 
as well as the value returned by the function. 

When using functions in HyperTalk statements you musr either use 
the word the before the fiinaion name or add parentheses after it 
(both forms are shown in the list that fallows). The parentheses are 
used to enclose any values on which die function operates. These 
valtjcs are chilled parameters. If the fonction takes several parameters 
(tt>r ex.inipic, the iiVLE^ct? fonction), you mu.st .separate the 
p:uiHneti_'rs with commas. V-ur a more compk-te discussion of 
fonctions Lind parameters, see the HyperTalk Help stack or the 
HyperCard II GS Script Languiige Guide. 



Syntax of function 


Value relumed by fiinction 


the abs of [numher] 
abs { nut/il/irr] 


Absoliirc value of numher 


annuity ( rate, periods) 


Currenc or future value of an annuity 


the atan of {mtmbtr) 
atan { numher) 


Arc langent number, expressed in radians 


averac)e ( litmtbfri.ist) 


Average of the numbers in numberLnt 


the c^hdrToWuni of chariU'Wr 
charToNuin { character) 


ASCII value of a charjcier 


the clickLoc 
ciickLoc { ) 


Horizontal and vertical coordinates of the 
point where the user last clicked 


the c omma n dKey 
cononandKey ( ) 


Posirioii of the Command key (the _ key): 
up or down 


compound [rate , periods) 


Present or liniirc value of a compound 
inrereit-bearing accoiini 


the CDS of numher 
cos ( Tiuinber) 


Cosine 0^ number, expressed in radians 
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Syntax of function 



Value returned by function 



the date 

the long date 

the short date 

the abbreviated date 

dateO 

the diskSpace 
diskspace { J 

the ejtp of number 
^xp ( number) 

the expl of number 
expl { number) 

the e>:p^ ol^ ftujftber 
exp2 { number) 

the foundChurtk 
foundChunk ( ) 

the foundField 
foundFxeld 

the foundLine 
foundLine f ) 

the foundText 
f QundTe>cr i ) 

the length of text 
length ( r;^) 

the In of number 
In ( number) 

the Inl of number 
Inl 1 number) 

the iog2 of number 
log2 { number) 

max ( numberList) 



Currcni date sei in the Apple llGS 



Amount of free space on the current disk 

Mathematical exponenrial raised to the 
power of number) 

1 less than mathematical exponential: 
expO-1 

The value of Z raised ro rhe power of number 

Description of where rhe text Is foand In 
a Held 

Which field the found text is in 
Which line the found lext is in 
Characters found by the find command 
Number of characrcrs in a text string 
Base- r (natural) logarithm number 
Base- f (natural) logarirhm of (I + mimber) 
Base-2 logarithm of number 
Highest number m numberList 
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SynUix of Rmctkin 



Value returned hy function 



min ( numbfrtht) 

I he mouse 
mouse t> 

the mouseClick 
moused ick () 

the mouseH 



the mouseLac 
mouseLoc {) 

the mouseV 
mouse V [ ) 

[the] number of objecti 
number {ohjects) 

[the] number of chunks in ttxT 
nmther {chunks in rext) 

[thel number of cards in background 
number tcards in background) 

the numToChar of number 
numToChar ( rmrnbcr) 

offset [tt-xtl, text2) 

the optionKey 
optionKey I) 

the param Of number 
pacam ( number) 

the paramCount 
paramCount {] 



Lowest number in numbfi'Lur 

Position oi [he mouie buiiiin; up or down 

True or false, depending on wheiher che 
mouse buttoo is clicked 

Horizontal position of the pointer on mouseH 
ihn screen 

Horizontal and vertical coordinaces of 
the pointer 

Vertical position of :he pointer 

Nvmiber of burtons/ fields oti the current 
card or background, or the number of 
b.ickgrounds or cards in the current st^lck 

Number ol- diaracters, words, lines, and ^o 
on in a specified text siring 

Number of cards in specified background 



Character correaponding to an ASCII vd 

Number of characters between the 
beginnings of rwo strings 

Position of the Option kcyi up or down 
Value of a parameter in a list 
Total number of parameters 
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Syntax of function 



Value returned by function 



the parains 
params () 

the random of number 
random ( number) 

the result 
result 

the round of jmmher 
ro\\x\d{ number) 

the screenRect 
screenRect () 

the seconds 
seconds ( ) 

the selectedChunk 
selectedChunk. [ ) 

the seiectedField 
select edFieidO 

the selectedLine 
select edLine f) 

the selectedTeitt 
select edText () 

the shiftKey 
shiftKey [> 

the sin of number 
sin [ nuJTihfr) 

the sound 
sound ( ) 



Encire lisr of parameiers 

Random inicger from 1 ro number 

A texc string if find or go is unsuccessful 

NearcsT Incegcr ro riumber{odd inceger 
plus 0.5 rounds up; even integer plus 0.5 
rounds down) 

The rectangle of die screen in which 
HyperCard's card window is displayed. 

Number of seconds bcrwcen midnighi 
January 1, 1904, and the current time 
in your Apple lICS 

Description of the location of the 
selected text 

Which field the selected text is in 

Which line the selected text is in 

Tevt currendy selected 

Position of the Shift key: up or down 

Sine of number, expressed in radians 

Name of die sound resource currently playing 
{or done if none is playing) 
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Svn[:i\ otTuiKtion 

the ^qct of number 
sqrt {numher) 

the tan of numher 
tari { numher) 

the target 
target t) 

the ticJts 
ticks 

the time 

the long time 

the shotf: t ime 

the abbreviated Lime 

timet) 

the tool 
tool ( ) 

the trunc of numher 
t Tunc {Jjnm her) 

the value of egression 
value [expression) 



VuIlil' rcturriL'd hy lLinak»n 

Square rooi ol a nunibL-r — 11 numba 'x^ 
negiicive gives reiuli NAN[001) 
meaning "not a number" 

Tangent of mimher, expressed in radians 

Description of the origitial rcdpient of 
a iiicssige 

Number of fjcks {Vm second) since the 
Apple liGS was last started 

Current time set in the Apple IlGS 



Name of the currently chosen tool 
Integer part of number 
Value of expression 
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The following lisc includes HyperTalk keywords and their synrax. 
Keywords arc predefined; you can't redefine chem — for instance, 
you can'c use a keyword as the name of a variable. 

Send is the only keyword char can be used in the Message box. 



do expresuon 



else 



ecid fiinctiouNiUnf 
end mtsSiigeNtimtf 
end if 
end repeat 



exit fitnctwnNamc 
exit messageName 



exit repeat 

exit to HyperCard 

function fitrtctioiiNamtf 

function fitnaiouNiiJt?!! parametcrList 

global variabltLhl 

if condition then 

next repeat 

on messageNarrre 

on mrisageNatne pammeterList 

pass Junction Name 
pa a s messngf'Nanw 

repeat [forever] 

repeat [for] wiimifr [times] 

repeat until condition 

riiipeat while coniliuon 

repeat with variable = start to finish 

repeat with variable = start down to finish 

return expression 

send " messageNarnelparameterList]" [to object] 
send " messageName[parameterLisf]'" to HyperCard 
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Clll lllCSStlgtS HyperGird sends these messages co che objects specified co inform 

chem of system events. Some messages include a variable (var), 
which depends on tlie message. For example, the arrowKey variable 
can be left, right, up, or down. 



Messages sent to a button 



ci(?leteButton ftiouseStillDown 

mo use Down mouseUp 

tnouseEnter mouseWithia 

mouse Leave newButton 



Messages sent to a Field 



closeFieid 

deleteField 

enterlnField 

mouseDown 

mouseEnter 

moiJseLeave 

mouseStiilDown 



mouseup 

mouseWithin 

newField 

openField 

retumlnField 

tabKey 



Messa^iies sent to the current card 



arrowKey var 


mouseStillDown 


c 1 OS eBac kg r ou nd 


mouseUp 




newBaokg round 


close Stack 


newCard 


cont colKey var 


news tack 


deleceBackground 


openBa ckg round 


deleteCard 


cpenCard 


deleteStack 


opens tack 


doMena var 


quit 


enterKey 


resume 


functionKey v^ir 


returnKey 


help 


show var 


hide var 


startup 


idle 


susr>end 


mouse Down 


tataKey 
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itlCS This section lists the properties of the HyperCard environment and 
of objects. 



Background properties 



cantDelete 
cantMDdi f y 
CO lor Set 
dontSearch 
ID 



number 
script 
showPict 
useColorSet 



Button properties 



autoHilite 

bottom 

bottomRight 

family 

f rameColor 

height 

hilite 

hilited 

icon 

iconBacJtColor 
i c on r ont Color 

ID 
left 

loc [ation] 

name 

number 



rect [angle! 

right 

script 

sharedHilite 

showName 

style 

textAlign 

textColor 

textFont 

text Height 

textSize 

textStyie 

top 

topLeft 
visible 
width 



Card prcjperties 



cantDelete 
cantModify 
colorSet 
do nt Search 
ID 



name 

number 

script 

showPict 

useColorSet 
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Field properties 



autoTab 

bottom 

bottomRight 

dont Search 

f rameColor 

height 

ID 

left 

loo [ation] 

iockText 

name 

r]U[iilj£?c 

rect [ angle j 

right 

script 



scroll 

sharedText 

showLines 

style 

textAlign 

text Color 

textFont 

textHeight 

textSize 

textStyle 

top 

topLelL 
visible 
wideMa rgins 
width 



Global properties 



b I indTypinq 

border Color 

cursor 

dragSpeed 

editBkgnd 

language 

lastError 

lockErrors 

lockMessages 



lockRecent 

lockScreen 
n umbe r F o rrciat 
power Keys 
print Temp late 
text Arrows 
userLeveJ 
userModify 
version 



Painting properties 



brush 

centered 

filled 

grid 

lineSise 

multiple 

multiSpace 

cm I" 3 1 n(?d 



pattern 

polySides 

textAlign 

cextFont 

textHeight 

textSize 

textStyle 
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Stack propettit^s 



cantUelete 
cantModify 
col or Set 

name 



script 
size 

useColorSet 
version 



Window properties 



bottom right 

boLLoGmRighL top 

height topLeft 

left visible 

loo I at ion] width 
rect [angle] 
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Constants 



Constajirs :ire named values rhat never change. You can't use the 
name of a constant as a variable name. 



Constants 



Description 



down TliL' valuL' i>l ihc key fuiiLritJii.s tor eIic Cumm.tnd, Opnon, 

;iiui sSliif[ keys ^tnd for [lit' ihousl' buccoii when prj^ssL'd 

empty A string concajning nothing ([he nu/isirln^} — 

snnie is " " 

false The upposire of true 

fonnFeeci The form feed cha['ac[er, ASCII 12 

lineFeed The line feed character, ASCII 10 

pi 1 he value of pi to 20 decimal placci ^ 

quote I'he double t|uo[a[ion mark character 

return The return cliaracier, ASCII 13 

apace The space characcer, ASCII 32 — same as " " 

Ldb The horizontal tab character, ASCII 9 

true The opposite of false 

up The value of the kev functions for the Command, Opdon, 

and Shift keys and for the mouse button when not 
currtntly pressed 

zero. . .ten The numbers through 10 
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or precedence The table below shows the order of precedence of HyperTalk 

opcrarors. The order of precedence decermines which operarion 
HyperCard perfornii first when evaluating an expression. Operators 
are evaluated from left to right, except for exponentiation, which is 
from right to left. Parentheses force evaluation in a certain order; for 
exaniple> 2'3+5 yields ii, but 2^(3+5) yields 16. 

Order Operators Type of operator 



1 ( ) Grouping 

2 - Minui sl^n for iiimihcrji 

not Logical negation for irue or false values 

3 ^ Exponenriatioii for numbers 

4 * / div mod Multiplication and division for 

numbers 

5 + - Addition and subtracrion for numbers 

6 ^ Concatenation of te\t 

7 ><<=>=<> ComparUon for numbers or texi 

is in Comparison tor lexi 

contains 

is not in 

S = <> ^ Comparison for numbers or rcxt 

is 

is not 

9 and Logical for true or false values 

10 or Logical for true or false values 
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Script editor The following cable li.srs kcyhoiird ci>mhinatiotis used Co edir nnd 

oard commands f^^mzi sc^pts. 



Kl-v 

eumhinaliun 



I'lTL^t 



■-A 
'H 

/up 

-V 
-X 

-period 
Etiitr 
Rtiiirn 

Opdon-Rt'mm 
Tab 



Select entire script 
Cnpy selection to Cliphnarcl 
1-ind lexi {s;ime as Find butifin) 
Find next occurrence of sanic text 
Find current selection 

Print selection or (if no selection) entire script d 
(same as Print button) 

Paste Clipboard contents at insertion point 

C '.ui selection to Clipboard 

Close script without saving changes 

Close script and save changes 

Return character — indicates end of HyperTalk statement 

Wrap line without renorn charaaer ("soft"' return- 
symbolized by -" in scripts. Doni use a "soft" return 
inside quotation marks.) 

Format script 
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Shortcuts for The following table ILsts shortcuts for displaying the scripts of 
seeing scripts HyperCard objects. 



Script 



Burron scripc 



Field scripi 



Card script 
Background script 



Shortciit(s) 



Click button while pressing 
Option and keys 

Doublt'-click buiion with Butuin 
tool while pressing Shin key 

Click field while pressing 
Option^ . and Shift kt'ys 

Double-dick field with Field cool 
while pressing Shift key 

Press -Option-C 

Press -Opnon-li 

Press -Option-S 



Synonyms and This table lists synonyms and abbreviacions that you can use in 

abbreviations '^''p"- 



Synonym or 

Term abbreviation 



abbreviated abbr 

abb rev 

background bg 

bkgnd 

backgrounds bqs 

bkgnds 

button btn 
buttons btns 



(tiininiiivilf 
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Synunyiii ur 
abbreviation 



card 

cards 

character 

characters 

corranandKey 

field 

fields 

gray 

location 

message box 

middle 

picture 

polygon 

previous 

rectangle 

regular 

seijond {lime unit) 



spray can 
ticks 



cd 

cds 

char 

chars 

cmdKey 

fid 

fids 

grey 

loc 

message 
snsg box 
msg 

mid 

piot 

poly 

prev 

rect 

reg 

sec 

sees 

seconds 

spray 

tick 
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algorilhm A step-by-srop procedure for solving a 
problem or accomplishing i\ VAsk. Writing 
HvperTiiik handler;; or progriinis in other 
languages often begins with figuring out a suitable 
rithm for a task. 

ASCII Acronym for Ajnerican Standard Code for 

Information Interchange, pronounced "ASK-ee." A 
standard char assigns a unique number to each 
text character and control character. ASCII code is 
used for representing text inside a eonijiucer and 
for transmitting information between computers 
and other devices. 

background A type of HyperCard object; a 
^^emplate shared by a number of cards- Each 
card with the same background has the same 
background picture, background fields, and 
background buttons in its bad^ound layer. 
Like other HyperCard objects, every background 
has a script. You can place handlers in a 
background script that you want to be accessible 
to all the cards with that background. 

hackgroimd blllton A button that is common to all 
cards sharing a biickgroiind, (^oiiip.tre with card 
button. 



baL'kj^rOLind field A field that is common to all 
cards sharing a background; its size, position, 
and default text format remain constant on jII 
cards associated with that background, bur its 
text can change from card to card. Compare with 
card field, 

bllckgl Oimd layer The layer behind the card layer, 
containing all the elements of the background. 
You see the elements of both layers when you look 
at a card, as if tlie card layer were a transparent 
layer in front of the background layer. The 
background button or background field 
created most recendy is the topmost object in 
the background layer (that is. closest within the 
background layer m the front of the screen). The 
background picture is behind (farther Irom the 
front of the screen) the objects in the background 
layer. 

background picture A picture that is common to 
all cards sharing a background- You see the 
background picmre by choosing Background 
from the Edit menu- Compare with card picture. 
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button A type of HyperCard object; a reccaiigular 
"hot spot" on a card or background chat 
responds when you click it according to the 
instructions in irs script, for example, clicking a 
right arrow button with the Browse tool can take 
you to the next card. 

card A type of HyperCard objects d rectangular area 
that ain hold buttons, fields, and graphics. All 
c^rds in a stack are the same size. Each card is a 
composite of two layers^ — ^a foreground layer, 
cdled the card layer, and a background Layer. 
You sec the elements of both layers when you look 
at a card, as it the card layer were a transparent 
layer in front of the background layer. Each layer 
can concajn its own buttons, fields, and graphics. 

Cdi'ii button A button in the card layer of a single 
card. Compare with background button. 

curd field A field in the card layer of a specific card; 
its size* position, text attributes, and contents are 
limited to the card on which the field is created. 
Compare with background field. 

card kiyer The layer in front of the background 
layer. You see the elements ol ho{h lavers when 
you look at a card, as if the card layer were a 
transparent layer in front of the background layer. 
The card button tjt card field created most 
recently is the topmost objcLt in die card layer 
[chat is, closest within the card layer to die front 
of the screen). The card picture is behind (farther 
from the front of the screen) the objects in the 
card layer and in front of all the elements in the 
background layer. 

card picture A picture in the card layer of a single 
card. Compare with background picture. 



chunk A piece of a character siring represented as a 
chunk expression. C^hunks can be specified as 
any combination of characters, words, items, or 
lines in a container or other source of value. 

chunk L^Xprcssion A HyperTalk description of a 
unique chunk of the contents of any container or 
other source of value. 

command A response to a particular mesiage; a 
builr-in message handler residing in HyperCard- 
Compare widi fimction and keyword. See also 
external command. 

command-key {:^-key) equivalent The 

combination of the ' ' key and another key m 
on the keyboard that you can press instead of " 
choosing a command from a menu. 

COmmcnt.S Descriptive lines of text in a script or 
program that are intended not as instructions 
for the computer but as explanations for people 
to read. Comments are set off from instructions 
by symbols called dcluniters, which vary from 
language to language. In HyperTalk, a double 
hyphen (— ) indicates the beginning of a 
comment. 

COnslanl A named value that never changes. For 
example, the constant empty stands for the null 
siring, a value diat can also be represented by the 
literal expression " ". HyperCard contains a M 
niuuber of constants, such as true, false* up, 
down, and pi. Compare with variable, 

container A place where you can store a value [lexi 
or a number). Examples are Belds, the Message 
boxi the selection, and variables. 

control structure A block of HyperTalk statements 
defined with keywords that enable a script to 
coturol the tirdcr or conditions under which 
specific statements execute. 
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current (adj.) The card* background, or stack yuuVc 
looking ac now. For example, the curreni aird is 
the one you ace in the active window on your 
screen. 

debug To locare and correct an error or the cause of 
a problem or malRinction in a computer 
program, such as a HyperTalk scripi, 

di'liinitf r A character or charactcri used to mark the 
beginninff or end oi ;i sequence ot characters; thai 
is. lo define limits. For example, in HyperTalk 
double quotation marks acr as delimiters for 
literals, and comments arc set off with rwo 
hyphens at the beginning of the comment and a 
^^eturn character at the end- 

empty Used to describe sctipts that contain no 
handlers, Evety HyperCard object has a script, 
even it the script is empty. See also null. 

expression A HyperTalk description of how to get a 
value; a source of value or complex expression 
built from sources of value and operators, 

t^xrernal command (Also known as XCMD.) A 
command written in a computer language other 
than HyperTalk but made available ro HyperCard 
CO extend its built-in command set. External 
commands can be attached to a specific stack or 
to HyperCard itself. See also external (unction. 

dXlernal function (Also known as XFCN.) A 
(unction wrinen in a computer language other 
than HyperTalk but made available to HyperCard 
to extend its builc-in function set. External 
Rincrions can be auached to a specific stack or to 
HyperCard ititlf. Sec also external command. 

Held A type of HyperCard object; a container in 
which you type field text (as opposed ctJ Faint 
[cxi). HypeiCard has (wti kinds ol (icldi — -card 
fields and background fields. 



luncUon A named value that HyperCard ailcnlarcs 
each time it is used. The way in which the value is 
cjilculated is defined intL'tnally for I lypL-rTalk's 
built-in tunctions, and you can define your own 
funcrions with (unction handlers. Somen mes a 
script must supply a function with staning values 
or parameters. Compare with command and 
keyword. 

iLini'tiun call The use of a function name in a 
HyperTalk statement or in the Message box, 
invoking either a function handler or a built-in 
(imction. 

function handler A handler that executes in 

response to a (unction call marching its name. 

global properties The propenies that determine 
aspects of the overall HyperCard environment. 
For example, userLevel is a global property diat 
determines the current user level setring. 

global variable A variable chat is valid for all 
handlers in which it is declared. You declare a 
global variable by preceding itii name with the 
keyword global. Compare with local vari^le. 

handler A block of HyperTalk statements m the 
script of an objcCT that executes in response to a 
message or a function call. The first line in a 
handler musr begin with the word on» and the 
last line must begin with the word end, Bodi on 
and end must be followed by the name of the 
message or function. HyperTalk has message 
handlers and function handlers, 

hienircliy Sec object hierarchy. 
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Home cards The first five cards in che standard 
Home stack, designed co hold butfons chat lake 
you to staclcs. Ltpplic.uioiis. .mil doLLiniunis. 
Choose Home from the Go menu (or press -H) 
to get CO che card in the standard Home stack that 
youVe seen most rcccndy. You can also type go 
home in the Message box or include it as a 
statement in a handler. 



local variable A variable that is valid only within 
the handler in which li is used (local variables 
need not be dechired). Compare with global 
variable. 

loop A section of a handler that is repeated until a 
limit or condition is met, such as in a repeat 
structure. 



HyptrTalk The built-in script language for 
HyperCard users. 

itlunlincr A character string of any length, beginning 
with an alphabetic character, containing any 
alphanumeric character and, optionally, the 
underscore character. Identifiers are used for 
variable and handlernames. 

iniCgLT A number with no decimal part. For 

example, -6, 0. and 125 are all integers; 2.54 is 
nor an integer. 

keTO'Ord Any one of die 1 3 words that have a 
special meaning in Hyper Talk state men cs. 
Examples of keywords are end. IE, on, repeat, 
and send. 

link A short script, usually in a bunon but 

potentially in any HyperCard object> that allows 
you to move immediately to a specific card in a 
stack, to an application, or to a document. For 
example, clicking a button that contains a link to 
your Addresses stack tal^es you immediately to the 
first card of that stack. 

IlLcral A string ol chanicccrs intended Uj be taken 
literally. In HyperTalk, you use quotation marks 
(" ") as delimiters to set off a string of characters 
as a literal, such as the name of an object or :^ 
^roup of words you want to be treated as a text 
string. 



Illt?ssage A string of characters sent to an object 
fi'om a script or die Message box, or that 
HyperCard sends in response to an event. 
Messages that come from che sy'iieni— from 
events such as mouse clicks, keyboard actions, or 
menu commands— are called system messages, - 
Rxamples of HyperTalk messages are mouseQp, " 
go, and push card. See also bandler and object 
bierarchy. 

Message box A container that you use to send 
iTiessages to objects or to evaluate expressions. 

message handler A handler that executes in 
response to a message matching its name, 

messai^e-pEtSsInt; urdLT The order in which a 
message is passed between objects. For example, 
a message that goes first to a button, such as 
mouseUp, would go next to the card, then to the 
background, then to the stack, and finally to 
HyperCard itself, unless intercepted and acted { 
upon by a handler. See also object hierarchy. 

metasymbol See syntax. 

null Having no value at all, not even zero. The 
HyperTalk constant empty is defined as a string 
containing nothing — that is. a null string, A 
string containing would not be empty. 
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number A character string consisting of any 
combination oi the numtT:il^i through 9, 
optioiijlly including one period (.) rcprcscnring a 
decimal value. A number can be preceded by a 
hyphen or a minus sign to represent a [icgativc 
value. 

object An clement of the HyperCard environment 
that has a script associated with it and that can 
send and receive messages. There are five Idnds of 
HyperCard objects: buttons, fields, airds, 
backgrounds, and stacks. 

object dt\scriptor A HyperTalk description chat 
^^pecifies a unique object. An object descriptor is 
^formed by combining the name of rhe tyf^e of 
object widi a specific name, number, or ID 
number. For example, background button 3 
is an object descriptor. 

object hierarchy The hierarchy of objects according 
to their message-passing order. For example, for 
a message such as mcuseup, the butron that first 
receives the message is higher in the object 
hierarchy than rhc background, the stack, or 
HyperCard itself. 

objed properties The propcnies that determine 
how HyperCard objects look and act. For 
example, the autohilite property of a button 

^^dctermines whether ihe button will highlight 
when clicked. 

Operator A chatacter or group of characters that 
causes a parcicular calculation or comparison ro 
occur. In HyperTalk, operators operate on values- 
For example, the plus sign (+) is an arithmetic 
operator that adtis numerical values. 



painting properties The properries that control 
aspects of HyperC^ard's painting environment, 
which is invoked when you choose a Paini lool. 
For example, the brush property determines the 
shape of die Brush tool. 

palelte A .small window that displays icons or 
patterns you can select by clicking. You can see 
two of HyperCard's palertes, the Tools palette and 
the Patterns palerte* simply by rearing off' their 
respective menus. To see the Go palette, type 
show go window in the Message box. See also 
tear-off menu. 

panimeterS Values passed to a handler by a message 
or funcdon call. Any expressions after die first 
word in a message are evaluated to yield the 
parameters; the parameters to a ftincrion call are 
enclosed in parentheses or, if there is only one, it 
can follow of. 

parameter variables Local variables in a handler 
chat receive the values of parameters passed with 
the message or fimction call initiating die 
handler's execution. 

picture Any graphic or part of a graphic, created 
with a Paint tool or imported from an external 
file, that is part of a card or backgroimd. 

pixel Shon for "picrure element"; the smallest dot 
you can draw on the screen. The position of the 
pointer is ohcn represented by two numbers 
separated by commas. These numbers are 
horizontal and vertical distances of the pointer 
from the left and top edges of the card window, 
measured in pixels. The upper-left corner o! the 
screen has the coordinates 0.0. 
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poinl In priiiLiJi^, the unit ul nKastiruiiicnc ciKchc 
lidglu of J [cxt L:h.ir;LLH,T; one |n>i[U is about '/lof 
an inch. Wlicn you sckn a loiu, you can also 
select a poinr size, ^^uch as 10-point. l2-poini> and 
so on. Also, a location on the screen described by 
two integers, separated by a comma, that 
represent horizoniaJ and vertical offsets measured 
'in pixels from the upper-left corner of the card 
window or (in the case of the card window itselO 
of the screen. 

properties The defining characteristics of any 
HyperCard object and of HyperCard's 
environment. For example, setting the user level 
ro Scripting changes the usyri^vel properly of 
HyperCard to the value b. Propenics are ofiren 
selected as options in dialog boxes or on palettes, 
or they can be set from handlers. See also global 
properties, object properties, p^undng 
properties, and window properties. 

Recent A special dialog box that holds pictorial 

representations of the last 1 8 unique cards viewed. 
Choose Recent from the Go menu ro get the 
dialog box. Also, as in recent card, a HyperTalk 
adjective describing the card you were viewing 
immediately prior to die current caid. 

rt'CUrsion The continuing repetition of an operacion 
or group of operations. Recursion occurs when a 
handler calls itself. 

resource fork The part of a fiie char contains 
resources such as icons and sounds. 

script A collection of handlers written in HyperTalk 
and associated with a particular object. Vou use 
the script editor to adtl to and revise an object's 
script. i-"vei-y objeci has a sLnpt> even though some 
scripts are empi)'; tliat is. ihcv i.oni,iin noihing. 



scrip! cdilnr A large window in which you can type 
and edit a script. The title bar of the script editor 
describes the object to which the script belongs. 
You can lise the Edit menUf the Script menu, and 
keyboard commands to edit text in the script 
editor. See also handler, object, and script. 

scripting The act of writing scripts, or programs in 
HyperTalk. Also refers to the user level that 
allows yoi» to look at and change objects' scripts. 

.St^iirch pHth When you open a file from within 
HyperCard, HyperCard attempts to locate die 
stack, document, or application you want by 
seardiing the folders listed on the Search Paths 
card in the Home stack. Each line on the Searcl^ 
Paths card indiaitei the location of a folder, 
including the disk name (and folder and subfolder 
names* if any). This information is called a search 
path, items in a search path are separated by 
colons, like this: ^my disk ;HyperCard 
i"oldei' :iiLy stack-s : 

Search Paths card A card in the Home stack used to 
store informadon about the location ot stacks, 
documents, and applications that you open while 
J lypert^ard is running. See also search path, 

St^lcctiton A container that holds the currendy 
selected area of text. Note that text found by the 
find command is not selected. ^ 

shared text Field text diat appears on every card in a 
background. Shared text can only be edited from 
the baclcground layen 

SOUrcv t)l value HyperCard's most basic 

expressions; the language elements from which 
values can be derived: constants^ containers^ 
Rincfions^ literals, and propcrties- 
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stack A type of HyperCard object chac consists of a 

collecrion uf cards; j HyperC^ard document- 
Statement A line of HyperTalk code inside a 
handler or typed into the Mess^e box, A 
handler can contain many statements. Statemencs 
within handleti are first sent as messages to the 
object containing the handler iind then to 
succeeding objects in tUc object hierarchy. 
Siatements typed into the Message box are sent to 
che current card. 

Sinw^ A sequence of characters. Yon can compare 
and combine strings in different ways by using 
^^perators. In HyperTalk> for example, 23 + 23 
^lill resuh in 46; but 23 & 23 will result 

in 2323. 

SUhprOCCdure A pare ofa larger procedure. You can 
write scripES that perform complex tasks by 
dividing the task into parrs and wricing message 
handlers to perform each sub procedure. 

syntax A description of the way in which language 
elements fit together to form meaningfiil phrases, 
A syntax statement hr a command shows the 
command in its most general i/ed form, including 
placeholders (sometimes called metasymbols) for 
elements you must fill in. as well as optional 
elements. 

S^B^m message A message sent by HyperCard to 
an object in response to an event such as a mouse 
click, keyboard action, or menu command. 
Examples of HyperCard system messages are 
mouseUp, doMenij. and newCard- 

target The object that first receives a message. 



tear-off menu A menu that you can remove from 
the menu bar by dragging the pointer beyond die 
menu's edge. HyperCard has tliree menus diat 
can be torn ofR the Tools menu, the Patrerns 
menu, and the Go menu. When torn off. these 
menus are teferred lo as palettes. 

text propc?l"t)' A quality or attribute of a character's 
appcamncc. Text propL-rties include style* font, 
and size. 

tick Approximately one-sixtieth (^/t>o) of a second. 
The wait command assumes a value in ticks 
unless you specify seconds by adding sees or 
seconds. 

user level A property of HypeiCard, ranging from 
I to 5t that determines which of HyperCard s 
capabilities are available. You can select the user 
level on the User Preferences card in the Home 
stack. Each user level makes all the options from 
the lower levels available, and gives you additional 
capabilities. The five user levels are: Browsing, 
Typing, Paintings Audioring, and Scripting. 

User Preferences card The last card in the Home 
stack, where you can set your user level and select 
or deselect the Blind Typing, Power Key^;, and 
Arrow Keys in Text options, 

value A piece of information on which HyperCard 
operates. Ail HyperCard values can be rreated as 
strings of characters — they are not formally 
separated into tj'pes. ^or example, a numeral 
could be interpreted as a number or as text, 
depending on what you do with it in a Hyper Talk 
handler. 
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Viiri:iblt' A named container char can hold a value 
coiisisring of a character string of any length. You 
can create a variable co hold soniL- value (cither 
numbers or text) simply by using its name with 
the put command and putting the value into ii. 
HyperCard hits local variables and global 
variables. Compart' wich constant, 

\vinduv\ properties The properties thar di^temiine 
how windows such as the Message box and the 
Tool and Pattern palettes are di.splaycd. For 
example, the visible property of a window 
determines whcdier that window is displayed un 
rhe screen. 
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& (ampersand) 54 

[] (brackets), syntax dements in 22,156 

(double ampersand} 40* 54 
— (double hyphen) 52, 54 
-^(soft return) 43, 54 



abbreviations, for scripcs 155—156 
About bucron 46-48 
algorithm, defined 157 

ampersand, double with text characters 40. 54 
ampersand (s), with text characters 54 

Ciation effects 
ird 120-121 
with Paint tools 122-126 
scripts for 120-126 
answer command 50 
defined 53 
syntax of 55 
Art Ideas stack 32 
ASCII, defined 157 



B 

background 

adding fields 23—26 

defined 157 

function of 7 

properties listed 1 49 
background button, defined 157 
background field 

defined 157 

moving message handlers CO 100-101,105 

with shared text 45—47 

specifying 46 
background layer, defined 157 
background picture, defined 158 
background properties, list of 149 
bg, ^tfi' bacl^round 
brush properties, values for 125-126 
Button Info dialog box 10 
buttons. See also bacl^ound button; card button 

About 46-^8 

adding to Home stack 15-17 
for animation stack 120-121 
customizing 11, 30 
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liLiEtons (contitnied) 

I lomc 9-1 I. \ 

Next 29-31 

Previous 31-32 

propercics listed 149 

Quit 63-66 

Show/Hide 127-128 

Sort 49-50 

Sound 96-97 

sysrem messages sent to 148 

Wrice Headline 128-129 

C 

Cane understand dialog box 21.103 
Lapitalizarion, in HyperTalk !3, 136 
card. See also index card; topic cai d 

adding ro stack 29 

animation seijucncc for 120-121 

defined 158 

labels for 41-42 

propmics listed l49 

system messages sent to 148 
card button, defined 158 
card field 

defined 158 

specifying 46 
Card Info dialog box 69 
card layer, defined !58 
uirtl picture, dt fiutd I S8 
choose command 131 

syntax of 132 
chunk, defmed 158 
chunk expression, defined 1 58 
click command 84 

syntax of 86 
ciickLoc function 7a-79> 85 
color, choosing for fields 3"^ 



t!(imnj.md key, in keyboard shortcuts S 
ccimnKU^I-key ct|uiv.ikiiu def'iiiLd I 'S8 
Loiiimand?!. ^;itJ external command; keyb 
commands 

alphabetical list of 137—141 

.answer 50, 53, 55 

choose 131 > 132 

click 84, 86 

defined )5, 158 

defining new 104 

doMenu 64, 84, 87 

drag 131, 133 

find 82-83. 84, 87 

go 34, 35 

hide 48, 53, 56 

lock screen 74-75, 84, 89 

play HI, 112 

put 38, 39. 53, 57 

set 77>78.84,91 

show 48,53,58 

show cards 131, 133 

sort 53.59 

syntax of 22 

visual 21-22.34,35,36 

wait 92 
comments 

.iddiui; to scripts 52 

defined 158 
constants 

defined 159 

iisiof 152 
container 

defined 159 

fijncfion of 37 

Message box as defiiult 57 

purcing values in 38-40 
control structure, defined i 59 
Credits field, creating 44—47 
current, defined 159 
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D 

date fijiiccion 78. 85 
debug, defined 1 59 
delimiter, defined 159 
aoMeiui tumiuiiiid 64, 84 

syntax of 87 
double hyphen ( — ), preceding commcnc 52, 54 
drag command 131 

syntax of 133 
dragspeed property 131 

E 

else keyword 84 
CE^^, defined 1 59 
ejTWteyword, defined 34 
entries field. index 
expression, defined 1 59 
external command, dcliiicd I 59 
external fiinction, defined 159 

F 

Field Info dialog box 24-25 

fields. Set' also background field; card field 

adding text 27-28 

adding to background 2.i-26 

as container 40—43 

creating 24-25 

defined 159 

Jacking and unlocking 47, 48, 80 
gloving between 29-32 

pop-up 44 

properties listed 150 

putting values in 40—42 

specifying kinds of 46 

system messages .sent to 148 

visible property of 127 
l-icld tool 24 
filled property 131 
rind command 82-83,84 

syntax of 87 
ton:, choosing for fields 25 



fiinciion call, defined 159 
fimction hancilcr, defined 160 
functions. .SW^/jAo external function 

alphabetical list of 142-146 

i:lickLoc 78-79, 85 

date 78, 85 

defined 78, 159 

mouse 131 

Ci^iidocti 125 

select edLine 81, 85 

value 82, 85 

G 

global keyword 51 
global properties 

defined 160 

list of 150 
global van;ihle t1 

defined I6U 
go command 34 

syntiix of 35 

H 

handler. Set also message handler 

defined 160 
hide command 53 

fimction of 48 

syntax of 56 
hierarchy, 5^^- object hierarchy 
hilite property 77,85 
Home button 

creadng 9-1 1 

visual efl^cct script for 19-20 
Home card, defined 160 
Home stiick 

adding butron.s 15—17 

first ciird 4 
HyperTalk language 2 

syntax of. 5ff syntax; syntax statements 
hyphen, double (~), preceding comment 52, 54 
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I,J 

idencificr, defined 160 
it keyword 84 

syntax of 88 
if srnicmres 

adding condidons 65—66 

function of 62-63 

ne.sting 66 
iniiigc (in visual fffects). li^i of ti^rnii 36 
index, script for generating 68-74 
Index button, creating 68-74 
index card 69 
integer, defined 160 
It. as variable 51, 54 
italics, for placeholders 22, 136 

K 

keyboard commands, for scripi editor 1 54 
keyboard slio recurs 

for creating fields 23—24.26 

for editing text in scripts 43 

for seeing scripts 155 
keywords 

alphabetical list of 147 

defined 1 60 

else 84 

end 34 

fijnction of 18 

global 51 

If 84,88 

on 34 

pass 107 

repeat 84 

send 109. Ill, 114, 147 
then 84 

L 

labels, script for adding to cards 41-42 
line breaks, in scripts I 14 
link, defined 160 
literal, defined 160 



local variable 49-51 

defined 160 
luL-jLiujL property, defined 79,85 
locking fields 47, 48 
lock screer. command 74— 75^ 84 

syntax of 89 
lockText property 81,85 
loop. See also repeat structures 

defined 161 

M 

rne, used for object 47. 54 

message. See also message handler; message- passing 
order; system messages 

defined l6l 
Message box 38 

calling handlers from 109-110 

.IS defnutt destinntion for put command 57 

defined Ifal 

putting values in 38—40 

send keyword in l47 
message handler 18 

calling from Message box 109—1 10 

calling from other handlers 101-103 

defined 17,161 

location of 96 

message-passing order and 97 
message-passing order 94.95 

defined 161 
metasymbol. Src^yni-ix 
mouseDown system message 53 
mouse ftinction 131 
mouseup system message 14 

defined 34 
music, fe' sounds 

N 

name property, defined 77 
nesting, if structures 66 
New ^iiack dialog box 6 
Next button, creating 29—31 
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D 

date Rmccioa 78. 85 
debug, defined 159 
delimiter, defined 159 
aoMenu command 64 » S4 

synr.ix of 87 
double hyphen ( — ), preceding commenr 52. 54 
drag command 131 

syntax ot 133 
dragSpeed property 131 

E 

el Be keyword 84 
enmry. defined 159 
eSKteyword, defined 34 
entries field. 5ff index 
expression, defined 159 
exceriiiil amim:inii. delliieil I S9 
external hinciion, defint-d 1 59 

F 

Field Info dialog box 24—25 

fields. See also background fields card field 

adding text 27-28 

adding rt* background 23-26 

as container 40^3 

creating 24—25 

defined 159 

docking and unlocking 47, 48, 80 
^Ploving between 29-32 

pop-np 44 

properties listed 150 

putdng values in 40—42 

specifying kinds of 46 

sysicm messages sent to l48 

visible property of 127 
Field rool 24 
rilled property 131 

-~\r4 command 83-S3i84 

syntax of S7 
font, choosing for fields 25 



fijnciion calk defined 1 59 
function handler, defined 160 
fiinciions. ^ff^zic external function 

aiphabedcal list of 142-146 

clickLoc 78-79.85 

date 78,85 

defined 78. 159 

jiiouse 131 

raiidoni 125 

selectedLine 81,85 

value 82.85 

G 

global keyword 51 
global properties 

defined 160 

list of 150 
global Viiri;ible 51 

defined 160 
go command 34 

syntax of 35 

H 

handler. See also message handler 

defined 160 
hide command 53 

fiinction of 48 

syntax of 56 
hierarchy. 5ef object hierarchy 
hilite propeiry 77, 85 
Home button 

creacing 9-1 1 

visual efl"ect script tor 19"'20 
Home card, defined 160 
Home stack 

adding buttons 15-17 

first card 4 
HyperTalk language 2 

syntax of i>f syntax; syntax statements 
hyphen, double {—), preceding comment 52, 54 
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I,J 

identifier, dcfiiiL-J 160 
if keyword 84 

syncax of 88 
if simctiires 

adding condinons 65-^6 

function of 62-63 

nesting 66 
iniiige (in visual effects), list of ccrnis 36 
index, script for generating 68-74 
Index button, creating 68-74 
index card 69 
integer, defined 160 
it, as variable 51, 54 
italics, for placeholders 22, 136 

K 

keyboard commands, for script cdi[or 1 54 
keyboard shortcuts 

for creating fields 23-24, 26 

for editing text in scripts; 43 

for seeing scripts 155 
keywords 

alphaberical list of 147 

defined 160 

else 84 

end 34 

Rinction of 18 
global 51 
if 84,88 
on 34 
pa5E 107 
repeat 84 

send 109. in. 114, 147 
then 84 



local variable 49-51 

dt.-finvd 160 
location property, defined 7^J, 85 
locking fields 47. 48 
lock screen command 74—75, 84 

syntax of 89 
lockText property 81,85 
loop. ^ff/^Zffj repeat structures 

defined 1 6 1 



M 

itie, used for object 47, 54 

message. See aho message handler; message-passing 
order; system messages 

defined 161 
Message box 38 

calling handlers from 109-1 10 

as default dcstinntion for put conimnnd '^'^ 

defined 16] 

putting values in 38^0 

send keyword in 147 
message handler 18 

calling from Message box 109-110 

calling fi-om other handlers 101-103 

defined 17, I6l 

k>caiion of 96 

message-passing order and 97 
message-passing order 94,95 

defined 161 
niel;LsymboL 5irsyni;ix 
mouseDown system message 53 
mouse fianction 131 
mouseUp system message 14 

defined 34 
music. 5;*^ sounds 



L 

labels, script for adding to cards 41-42 
line breaks, in scripts 1 1 4 
link, defined 160 
literal, defined 160 



N 

name properfy, defined 77 
nesting, if structures 66 
New I^iack dialog box 6 
Next button, creadng 29-31 
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note (music), spcdfying 112, 113 
null, defined 161 
number defined 161 



objccr 

defined 161 

scripring :ind 5» 17 
objea descripcor, defined 161 
objea hierarchy. Seealso message-passing order 

defined 161 
object property, defined 161 
oaave, specifying 112 
on keyword, defined 34 
of^^ard system message 43, 53 
operators 

defined 161 

order of precedence in HyperTalk 1 53 

in scripts 54 
Option key, in scripting shortcuts 1 55 
O prion- Return {-) 

defined 43 

fiinction in lexr 54 

p 

paindng, with HyperTalk scripts 122—124 
painting properties 

defined 162 

list of 150 
p^^ tools 

in animation scripts 122—123 

script editor and 123 

using 32-53 
palette, defined 162 
parameters 

defined 162 

for Sanctions 142 
parameter variable, defined 162 
parentheses ( () ). in syntax of fiinctions 142 
pass keyword 107 



pattern properry 131 

values for 124 
pause, setting with wait command ^2 
period (.) 

in doMenu command 87 

with duration code 113 
picture, defined 162 
pixel 79 

defined 162 
play command 111 

syntax of 112 
point, defined 86, 162 
presencation stack, creating 1 17—1 19 
Previous button, creating 31—32 
properties. See also ^ohai properties; paincing 

properties; text properties; window properties 

alphabetical list of 149-151 

backgrotmd properties 1 49 

button properties 149 

card properties 149 

defined 1 62 

dcagSpeed 131 

field properties 150 

filled 131 

hilite 77, 85 

location 79, 85 

lockText 81, 85 

name 77 

setting 77—78 

visible 127 
put commai^d 

defined 53 

fiancf ion of 38 

syntax of 39, 57 

Q 

Quit button 

creating 63-66 
quotation marks (" ") 

line breaks inside 1 14 

with sounds in a script 112 

with text charaaers 39-40 
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R 

random events, scdpcs for swcks producing 1 26- 1 29 
randoixi funccion 131 

in setting patterns 125 
Recent dialog box, defined 1 62 
recursion, defined 162 
repeat keyword 84 

syntax ot 90 
repeat strucmres 66, 123—124 
resource fork, destined 162 

s 

screen 

locacing horizontal and verric:il coordinates 79. 

125, 133 
locking and unlocking 89 
script edicor 
defined 163 

keyboard commands for 43^54, 154 
opening 21 
with paint tools 123 
using 12—13 
scripting- 5^^ scrip r editor, using 
defined 163 
Objects menu and 5 

abbrevidiions and synonyms lor I 55-1 56 
adding commcncs 52 
choosing [ools from wiihin 132 
defined 163 
format of 13 

keyboard shortcuts for seeing 155 

long lines in 114 

message handlers in 1 7 

purpose of 14 

saving changes 13 

statements in 15 
search path> defined 163 
Search Paths card, defined 163 

:;i. Li-:cjLL?iJLijiij l\n)Llioil L S5 

selection, defined 163 



send keyword 1 1 1 

in Message box 109,147 

syntax of 1 1 4 
set command 

with properties 77, 84 

syntax of 78. 91 
shared text, defined 163 
shortcuts. 5a' keyboard shortcuts 
show cards command 131 

syntax of 1 33 
show command 

defined 53 

function of 48 

syntax of 58 
Show/Hide huiton, creacing 127-128 
"soft" return character iVi- Option-Return 
Sort button, creating 49-50 
aot'L command 

defined 53 

syntiix ol 59 
Sound button, creating 96-97 
sounds 

with play command 111 

scripts for playing 96-97. 102-104, 106-109 

syntax for creating 112-114 
source of vakje. defined 1 63 
spLvd (ill visual cIlecEs). li.sl oi terms 36 
SL]uare brackets [jj ). in synta,\ notation 22. 136 
stack 

creating 6-7 

defined 163 

properties listed 151 
statement, defined 15* 163 
string, defined 163 
style property, defined 77 
sub procedure, defined 1 10, 163 
synonyms, tor scripts 155-156 
syntax. 5fv f?i^7 commands 
conventions 21-22 
defined 163 
errors in 21 
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syntax statements 

commands 1 37—1 4 1 
functions 142—146 
keywords 1 47 
notation for 22, 136 

system messages 101 , 11) 
alphabetical list of 148 
defined 14, 164 
mouseDown 53 
moijseUp 14. 34. 94 
openCard 43, 53 



T 

target, defined 164 
tG^pff menu, defined 1 64 
tei^o, specifying 112 

text, keyboard commands for editing 43, 154 

text properties, defined 164 

Text Style dialog box. choosing fonts 25 

the. in fiinccions syntax 142 

then keyword 84 

tick, defined l64 

time Sanction 39» 78 

tools, selecting widi choose 132 



variable. See also global variable; local variabk 
parameter variable 

defined 49. 164 

naming 51 
visible property 131 

dcfin^^d 128 
visual command 

defined 34 

syntax ol 21—22,36 
visual effects 

list of 36 

scripts for 19-20 



W, X, Y, Z 

wait command, syntax of 92 
window pruperiies 151 

defined 164 
Write Headline button, creating 128-129 



U 

unlock screen command, syntax of 89 
user level, defined 164 
User Preferences card 5 
Refined l64 

V 

value 

defined 164 

purcing into containers 38-40 
putting into fields 40-42 
value function 82, 35 
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Script editor Tlie following ciihk- lists kevbo:ird combinations used tu edit .ind 

keyboard coiTimands ^rmat scripts. 



Key 

combination Effect 



■-C 
"-F 

Enter 
Rt^mrn 

Option-Return 



Select i^niircscripi 
Copy selection to Clipboard 
Find text (same as Find liution) 
Find next ocairrence of same text 
Find ciirrenl selection 

Print selection or (if no selection) entire script 
(same as Print button) 

Paste Clipboard contents at insertion point 

Cut selection to Clipboard 

Close script without saving changes 

Close scrip! and save chan^jes 

Return character— indicates end of HyperTalk statement 

Wrap line without return character ( "soft" return— 
symisolized by ^ in scripts. Don't use a "soft " return 
inside quotatioEi marksj 
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Format script 



©Apple Computer, Inc., 1990 

Apple, [he Applf Itiyn, jnd HypcTlalk ure reyistcrctl Iradeniurk,s 
of Apple Computer 3nc, 



ConillVands This section lists the syntax of all Hyperm commands. For more 
information abotit other HyperTalk commands, see che HyperTalk 
Help stack or the HyperCard liGS SaiptUnguagt' Guide. 

add numb^ ta [chunk of] container 

answer question 

answer question with reply 

answer ijuesrioN with repfyl or reply2 

answer question with rrplyl or reply2 or replyJ 

answer file text [of type fileType] 

arrowKey direction 

ask qt4^stio7i [with defaultAnsiver] 

ask password question Iwith defaultAmwer] 

ask file r^^r With fileName\ 

beep [nwmierl 

choose toolName tool 
choose tool number 

click at 

click at /'o/rt' with ^^y/ 

click at point with key2 
click at with keyh keyl. key5 

close file fikNivne 

close printing 

controlKey keyNumber 

convert 1 rW/i ofi .."f.^/^r-r to forrmt [and ^^^1 
create stack stackNnme [with bu<kground\ 

delete cAwn^ of container 
delete [stack] stackNamc 

dial . 
dial Titt/nifTwith modem {modemCommdnm 

divide If/^J^n^of] fPni^'"f^by mmiber 



doMenu menuhem [without dialog] 

drag from point to point 

drag from poi7it to point with keyl 

drag from point to point with hylf key2 

drag from point to point with ^'fj'i, ^^^j 

edit script of object 

enter Key 

export paint to file jilemime 
find text 

find text [ in hackgroundField ] 
find chars [in backgroundfield \ 

find word /wT [in backgrouttdfieki ] 
find whole ;m fin backgroundField ] 
find string /rvr [in backgroundfield] 

fianctionKey keyNumber 

get expression 

go [to] j-Mfjt 

go [toj background [of j^aci J 

go [to] card [of backgroufid] [of jMc^] 

help 

hide button 

hide ^fi^/ 

hide card picture 

hide picture of card 

hide background picture 

hide picture of background 

hide menuBar 
hide message box 
hide tool window 
hide pattern window 
hide go window 
hide card window 



import paint from file filename 



lock [the] print Template 



lock screen 

multiply [chunk of] container by number 

open [fiicName with] applicationName 

open file fiUName 

open printing [with dialog] 

play sound [tempo] [notes] 
play stop 

pop card 

pop card into [chunk of] container 

pop card after [chunk of] container 

pop card before [chunk of] container 

print field 

print fileName with applicatiotiNamc 

print card 

print number cards 

print card 

print all cards 

push card 

put expression 

put expression into [chunk of] container 
put expression after [chunk of] contaiiier 
pur expression before [chunk of] container 

read froin file fiUName at JWrt for numherOjChars 

read from file fileName for numberOfZhars 

read from file fiUName until character 

read from file fileName until end 

read from file fileName until eof 

reset paint 

returnKey 



save this stack as fileNnme 

save this stack as pathName 

save I stack I stackName as fil^Name 

save [stack.] smckName as pathName 

select button 
select field 

select text of container 
select before text of container 
select after text of container 

select chunk of container 
select before chunk of container 
select after chunk of contaiucr 
select empty 

Note: container \s a field or the Message box, 

set [the] property [of ohject] to e>^ression 

show button |at point] 
show field [at point] 

show card picture 
show picture of card 
show background picture 
show picture of background 

show menuBar 

show message box 

show tool window [at point] 

show pattern window (at point] 

show go window [at point] 

show card window 

show number cards 
show all cards 

sort [sortDirection] [sortStylc] by expression 
subtract number from [chunk of] container 



tabKey 



T ypie U-Xi 

type te^£ with kty! 

type text with kty!, kfy2 

type /wrt with keyl, keyl. k€y3 

unlock (the] printTemplate 

unlock screen 

unlock screen with visimlEffict 

Note: z^irt^/£^rf is any form of the visual comm; 

visual [effect] effectName [speed] [to image] 

wait [for] number [seconds] 
wait until condition 
wait while condition 



write text to file fi/eName [at JMrf] 



